v1
latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KBGet a task
Scope: runs:read. Free. Reads back the task you submitted with POST /v1/tasks, using the id that call returned. A task IS a run, so the payload is identical to GET /v1/runs/{run_id} and either path may be polled.
Response
The task, as a run.
EFFECTIVE wall-clock budget after the server applied its ceiling. Echoed back so a clamp is never silent: request 86400 against a lower server ceiling and you see the value the run is actually held to, instead of discovering it as a surprise DEADLINE_EXCEEDED.
EFFECTIVE awaiting-human timeout after the server applied its ceiling, echoed back for the same reason as deadline_seconds.
Terminal outcome envelope: passed (boolean), status, summary, usage, and verdict only when a verifier pass ran. summary is the LAST 2000 characters of the trajectory, so it carries the agent's final answer; it is not the full trajectory and there is no output field. To read a complete trajectory, or a final answer you intend to parse, use GET /v1/runs/{run_id}/log.
Lifecycle callback destination. Agent Run terminal callbacks are transactionally queued in a durable outbox and delivered at least once, with at most 3 durably recorded delivery attempts. A crash after HTTP send but before durable acknowledgement can add duplicate physical sends. Stable Coasty-Delivery equals body id and logical delivered_at survives retries; receivers must deduplicate it. The non-terminal awaiting-human callback is best-effort in-process, can be missed on a worker failure, and uses (run.id, event, run.awaiting_human_since) for deduplication. GET the run for authoritative state.
Returned by create and its exact bounded Idempotency-Key replay; null on get/list. The pinned per-run secret is encrypted at rest through delivery/replay recovery and later scrubbed. Verify raw-body deliveries with HMAC-SHA256 before accepting the Coasty-Delivery deduplication key.