Cancel a task run
Stop a run that is pending, running, or waiting for input, and cancel the image, audio and video generations it still has in flight (they are billed only when they finish). Stopping is asynchronous, like the agent runtime it asks: a run mid-step finishes that step first. The response is the run with cancel_requested_at set; it settles as cancelled moments later (poll GET /task_runs/, or listen for task_run.cancelled). A run that was not mid-step is cancelled at once. Cancelled runs do not count as failures. Repeating the call returns the run unchanged. 409 run_not_active if the run has already settled.
Authorizations
API key in the format: Bearer {api_token}
Headers
Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.
255Path Parameters
Task run id (trun_...)
Response
The cancelled run.
The run's own conversation (aichat_...): what it read, called and said. Read it with search_chats.
When a stop was requested. The run stays running until it reaches its next step, then settles as cancelled.
pending, running, completed, failed, needs_input, timed_out, unknown, skipped, cancelled condition, no_paid_plan_or_credits, no_recent_activity, no_task_activity, no_personal_sources, wake_gate, wake_limit, rate_limited, misfire, task_busy, account_at_capacity, null delivered, not_delivered, not_requested, unknown How the agent closed a completed run: verified (it re-checked the result), recorded (it reported without re-checking), or recovered (it never reported; summary is its last message). Null unless an agent turn completed the run.
verified, recorded, recovered, null scheduled, event, manual The event that started this run, {type, data}, exactly as the run received it; data matches the event's webhook payload. Null for a run no event started. POST /task_runs/{id}/replay runs the task again on it.
The run (trun_...) whose event this run replays. Null unless started by POST /task_runs/{id}/replay.

