Skip to main content
POST
Resume a stopped task run

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

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.

Maximum string length: 255

Path Parameters

id
string
required

Task run id (trun_...)

Body

application/json
message
string

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.

id
string
required
object
string
required
task_id
string
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
needs_input,
timed_out,
unknown
summary
string | null
required
error_message
string | null
required
test_run
boolean
required
input_tokens
integer
required
output_tokens
integer
required
credits_consumed
integer
required
tool_calls_count
integer
required
duration_ms
integer | null
required
started_at
string<date-time> | null
required
completed_at
string<date-time> | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
captured_deliveries
array
required
pending_approval_ids
array
required