Skip to main content
POST
Continue a task

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"

Body

application/json
message
string
required

What to change, add, or continue.

Minimum string length: 1
Example:

"Add founder LinkedIn URLs for all existing rows, then continue until there are 25 rows."

input_files
string[] | null

Task-local filenames returned by POST /validate-upload.

wait
any
default:false

Set to true to block for the whole turn (legacy). Other values return immediately.

Response

Turn finished (wait: true) or accepted for background execution.

task_id
string
required
Example:

"8fab6f34"

name
string | null
Example:

"Series A AI security companies"

status
string | null

Legacy; use state and done. plan (idle, or finished), execute (working), accepted (queued), deleted.

Example:

"execute"

phase
enum<string> | null

Legacy; use state and done.

Available options:
plan,
execute
Example:

"execute"

activity
string | null

Legacy; use state and done. idle, queued, planning, executing or thinking. queued is waiting for a free slot and starts on its own. Finished is idle.

Example:

"executing"

output_count
integer | null
Example:

10

credits_used
integer | null
created_at
string | null
updated_at
string | null
poll_after_s
integer | null

Seconds to wait before polling status again.

Example:

5

status_url
string | null
Example:

"/task/8fab6f34/state"

task_url
string | null

API resource URL, relative to the API server. Open the chat in the browser at https://platform.autumn.ai/?task={task_id}.

Example:

"/task/8fab6f34"

output_url
string | null
Example:

"/task/8fab6f34/output"

stream_url
string | null
Example:

"/task/8fab6f34/stream"

queue
QueueState · object | null

Present while activity is queued.

state
string | null

A2A lifecycle state: submitted, working, input-required, completed, canceled or failed.

done
boolean | null

True for input-required, completed, canceled and failed.

stage
string | null

Current stage while the task is active.

message
string | null

Latest public-facing task message.

answer
string | null

Full saved assistant answer for a completed chat task without output rows.

progress
Progress · object | null

Rows saved and optional target count.

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_messages
QueuedMessage · object[] | null

Follow-ups queued behind the current turn.

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.