Smart Agent TeamsGet Run Context
Get the same context `POST /runs/claim` returns, without claiming the run. Use it to inspect or re-run a run: the run with its transcript, the agent and its manager, the company brief, the task with its comments, the task's goal chain and project, and `lease_seconds`. Answers 404 `NOT_FOUND` for runs outside this company.
Get the same context POST /runs/claim returns, without claiming the run.
Use it to inspect or re-run a run: the run with its transcript, the agent and
its manager, the company brief, the task with its comments, the task's goal
chain and project, and lease_seconds. Answers 404 NOT_FOUND for runs
outside this company.
HTTPBearerAuthorizationBearer <token>run_id*Run Iduuidcompany_id*Company IduuidSuccessful Response
application/json- response
Everything a runner needs to execute a claimed run.
agent*comments?array<>[]company*goals?array<>[]lease_seconds*Lease Secondsmanager?|nullproject?|nullrun*task?|nullcurl -X GET "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/context"{ "agent": { "adapter": "string", "avatar_seed": 0, "capabilities": [ null ], "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf", "created_at": "2019-08-24T14:15:22Z", "heartbeat_cron": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "instructions": "string", "last_activity": "2019-08-24T14:15:22Z", "monthly_budget_cents": 0, "name": "string", "open_tasks": 0, "reports_to_id": "9a08cb01-6bdc-412f-ad45-35a6f5d74f8e", "role": "string", "spend_mtd_cents": 0, "status": "string", "title": "string" }, "comments": [], "company": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "mission": "string", "name": "string", "task_prefix": "string" }, "goals": [], "lease_seconds": 0, "manager": { "adapter": "string", "avatar_seed": 0, "capabilities": [ null ], "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf", "created_at": "2019-08-24T14:15:22Z", "heartbeat_cron": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "instructions": "string", "last_activity": "2019-08-24T14:15:22Z", "monthly_budget_cents": 0, "name": "string", "open_tasks": 0, "reports_to_id": "9a08cb01-6bdc-412f-ad45-35a6f5d74f8e", "role": "string", "spend_mtd_cents": 0, "status": "string", "title": "string" }, "project": { "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "monthly_budget_cents": 0, "name": "string", "repository": "string", "spend_mtd_cents": 0, "status": "string", "tasks_done": 0, "tasks_total": 0 }, "run": { "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, "transcript": [ {} ], "trigger": "string" }, "task": { "assignee_agent_id": "8ff43445-51ff-4235-b9d4-d8007d4d5dc3", "completed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "created_by_agent_id": "acd3b99b-57bd-46a1-809a-5d915f3c2609", "created_by_user_id": "209f54c4-4c33-43bc-9c6a-ef4c65ad7473", "description": "string", "due_date": "2019-08-24T14:15:22Z", "goal_id": "3854d9ad-4bca-4a70-a63e-7c6bc2f12aee", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "key": "string", "number": 0, "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef", "priority": "string", "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9", "sort_order": 0, "started_at": "2019-08-24T14:15:22Z", "status": "string", "title": "string", "updated_at": "2019-08-24T14:15:22Z" }}Cancel Run POST
Cancel a queued or running run. Equivalent to `PATCH /runs/{run_id}` with `status: cancelled` and no `runner_id`, so it works whichever runner holds the run. The agent's budget is enforced as for any finished run. Fails with 400 `RUN_FINISHED` if the run already finished.
Heartbeat Run POST
Extend the runner's lease on a running run by stamping `heartbeat_at`. `runner_id` must match the runner that claimed the run. 409 `RUN_LEASE_LOST` means stop work: the run is no longer `running` (cancelled, expired or finished) or is held by another runner. Publishes no events.