Skip to main content
POST
Resolve a waiting 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
type
enum<string>
required

Which resolution flow to run.

Available options:
approvals,
input,
complete
approvals
object[]

Required for type: "approvals". One decision per pending approval; must cover the exact pending set.

message
string

Required for type: "input". Follow-up instructions for the agent.

Response

Resolved inline (type complete).

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