Run

List Runs

get

Retrieves a paginated list of runs for the authenticated user

Authorizations
Query parameters
includeEventsbooleanOptionalDefault: false
pagenumber · min: 1 · max: 1000OptionalDefault: 1
pageSizenumber · min: 1 · max: 100OptionalDefault: 10
Responses
200

Runs retrieved successfully

application/json
get
GET /v1/runs HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "runId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "RUNNING",
    "stepsFinished": [
      {}
    ],
    "result": {},
    "createdAt": "2025-09-06T23:45:16.580Z",
    "updatedAt": "2025-09-06T23:45:16.580Z"
  }
]

Create a new Run

post

Creates a new run with the specified intent and selected integrations

Authorizations
Body
intentstringRequired

The intent or goal for the run

Example: Create a summary of the latest sales data
selectedCustomerIntegrationIdsstring[]Required

Array of selected customer integration IDs to use for the run, or use ["*"] to include all active integrations

Example: ["integration-1","integration-2"]
contextstringRequired

Additional context for the run execution

Example: Focus on Q4 2023 data with regional breakdown
userIdstringRequired

The ID of the user who is initiating the run

Example: user-123
approvalStrategystring · enumOptional

Approval strategy for the run

Example: NONEPossible values:
Responses
201

Run successfully created

application/json
post
POST /v1/runs HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 225

{
  "intent": "Create a summary of the latest sales data",
  "selectedCustomerIntegrationIds": [
    "integration-1",
    "integration-2"
  ],
  "context": "Focus on Q4 2023 data with regional breakdown",
  "userId": "user-123",
  "approvalStrategy": "NONE"
}
{
  "runId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "QUEUED",
  "stepsFinished": [
    {}
  ],
  "plan": {
    "planType": "json",
    "plan": {}
  }
}

Approve or deny a run or its individual steps

get

Approve or deny a run or its individual steps

Authorizations
Query parameters
tokenstringRequired
Responses
201

Run successfully created

application/json
Responseany
get
GET /v1/runs/approval HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

No content

Get Run details

get

Retrieves detailed information about a specific run

Authorizations
Path parameters
runIdstring · uuidRequired

Unique identifier of the run to retrieve

Responses
200

Run details retrieved successfully

application/json
get
GET /v1/runs/{runId} HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

{
  "runId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "RUNNING",
  "stepsFinished": [
    {}
  ],
  "result": {},
  "createdAt": "2025-09-06T23:45:16.580Z",
  "updatedAt": "2025-09-06T23:45:16.580Z"
}

Abort a Run

delete

Aborts a running or queued run by its ID

Authorizations
Path parameters
runIdstring · uuidRequired

Unique identifier of the run to abort

Responses
200

Run successfully aborted

No content
delete
DELETE /v1/runs/{runId} HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

No content

Server-Sent Events stream for a Run

get

Establishes a Server-Sent Events connection to stream real-time updates for a run

Authorizations
Path parameters
runIdstring · uuidRequired

Unique identifier of the run to stream events for

Responses
200

SSE stream established successfully

text/event-stream
Responsestring

Server-sent events stream with run updates

get
GET /v1/runs/{runId}/sse HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

text
PreviousIntegrationNextFeedback