Smart Agent Teams
EndpointsRuns

List Runs

List the company's runs, newest first, capped at `limit` (default 100, max 500). Filter by `agent_id`, `task_id` and `status` (repeatable: `queued`, `running`, `succeeded`, `failed`, `cancelled`). Transcripts are omitted; fetch a single run for its transcript.

GET
/api/companies/{company_id}/runs

List the company's runs, newest first, capped at limit (default 100, max 500).

Filter by agent_id, task_id and status (repeatable: queued, running, succeeded, failed, cancelled). Transcripts are omitted; fetch a single run for its transcript.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

company_id*Company Id
Formatuuid

Query Parameters

agent_id?|

Only runs of this agent

task_id?|

Only runs for this task

status?array<string>|

Run status to include; repeat for several

limit?Limit

Maximum number of runs to return

Range1 <= value <= 500
Default100

Response Body

Successful Response

application/json
  1. response
[index: integer]?
curl -X GET "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs"
[  {    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",    "cost_cents": 0,    "created_at": "2019-08-24T14:15:22Z",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "routine_id": "f53c5ff7-cfb7-4f43-8b79-3421a01d8e2a",    "runner_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "string",    "summary": "string",    "task_id": "736fde4d-9029-4915-8189-01353d6982cb",    "tokens_in": 0,    "tokens_out": 0,    "trigger": "string"  }]

Update Company Project PATCH

Update a project's name, description, repository, status or budget. Only fields present in the body are changed. `status` is `active`, `paused`, `completed` or `archived`; money is in integer cents (`0` = no limit). Publishes `project.updated` when something changed.

Claim Run POST

Atomically take the oldest queued run this runner can execute. Skips agents that are dormant or already running something, marks the run running under the caller's runner_id and returns its full context. Answers 204 when there is nothing to do. Runners must start runs through this, never by PATCHing status=running, so two runners can't execute the same run.