COcoasty
runs

Cancel a run

Scope: runs:write. Free. Cancels an in-flight run.

post/v1/runs/{run_id}/cancel

Request

Response

The cancelled run.

idstring required
object'agent.run' required
status'queued' | 'running' | 'awaiting_human' | 'succeeded' | 'failed' | 'cancelled' | 'timed_out' required
machine_idstring nullable
taskstring
cua_versionstring
instructionsstring nullable
max_stepsinteger
deadline_secondsinteger

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.

awaiting_human_timeout_secondsinteger

EFFECTIVE awaiting-human timeout after the server applied its ceiling, echoed back for the same reason as deadline_seconds.

on_awaiting_humanstring
steps_completedinteger
credits_chargedinteger
cost_centsinteger
resultobject nullable

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.

errorobject nullable
awaiting_human_reasonstring nullable
metadataobject nullable
webhook_urlstring nullable

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.

webhook_secretstring nullable

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.

created_atstring nullable
started_atstring nullable
awaiting_human_sincestring nullable
finished_atstring nullable
request_idstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.