Resume a stopped task run
Pick a stopped run back up in its own conversation instead of repeating it: the transcript is already the agent’s context, so it continues from what it saved rather than redoing the work. Starts a new run that adopts the original’s chat. Pass message to steer the continuation; without it the agent is told to read back over what it did and carry on. 422 run_not_resumable if the run already completed or has no conversation (send it a follow-up instead), 409 run_busy if it or another run of the task is still in progress.
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_...)
Body
Optional instructions for the continuation. Defaults to asking the agent to resume from its last saved step.
Response
Accepted — the resumed turn runs in the background on a new run; poll GET /task_runs/{id} or open its stream.
pending, running, completed, failed, needs_input, timed_out, unknown 
