Execute a task

curl --request POST \ --url https://api.autumn.ai/task/{task_id}/execute \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "message": "<string>", "input_files": [ "<string>" ], "wait": false } '

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 | null

Instruction to include with the execution.

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.

Show child attributes

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.

Show child attributes

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.

Show child attributes

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.

Show child attributes

Next · object | null

Suggested next action and API call.

Show child attributes

version

string | null

Changes when public task status changes.

app_url

string | null

Open the task in the Autumn app.

Reference

Endpoints

Authorizations

Path Parameters

Body

Response