Skip to main content
GET
Get task state

Authorizations

X-API-Key
string
header
default:YOUR_AUTUMN_API_KEY
required

Your Autumn API key.

Path Parameters

task_id
string
required

The task_id returned by POST /task or POST /task/start.

Example:

"8fab6f34"

Query Parameters

wait
integer
default:0

Wait up to 50 seconds for the first status version change (values are clamped to 0-50).

Response

Task state.

task_id
string
required
exists
boolean
required
active
boolean
required

Legacy. True while a turn is running, which can continue after rows are saved. Use done to tell when the task is finished.

status
string
required

Legacy; use state and done.

phase
string
required

Legacy; use state and done.

activity
string
required

Legacy; use state and done.

state
string | null

Lifecycle state: submitted, working, input-required, completed, canceled or failed (A2A). Poll until done is true.

done
boolean | null

True once the task has stopped: input-required (reply to continue; see next), completed, canceled or failed. Poll until true, then check state. Saved rows are readable from /output before this.

message
string | null

Latest public-facing task message.

progress
Progress · object | null

Rows saved so far (rows) and the optional target. Saved rows are readable from /output while done is false.

run_id
string | null
heartbeat_at
string | null
pending_op
string | null

A queued message or execute that has not started yet.

pending_op_stale
boolean | null

True when the queued op has waited past its TTL and will not start.

last_submit_error
string | null

Why the last queued (202) message or execute was rejected when it ran, e.g. out_of_credits. Empty when it ran.

last_submit_error_at
string | null
queue
QueueState · object | null

Present while activity is queued.

credits_used
integer | null

Credits used by this task.

stage
string | null

Current stage while the task is active.

elapsed_s
integer | null

Elapsed seconds in the current or most recent run.

queue_position
integer | null

Place in line for a queued task, or null when not queued.

queued_count
integer
default:0

Pending queued follow-ups.

outcome
string | null

Normalized completed outcome.

error
Error · object | null

Public failure code and recovery guidance.

next
Next · object | null

Suggested next action and API call.

version
string | null

Changes when public task status changes.

app_url
string | null

Open the task in the Autumn app.