Skip to main content
POST
Stop 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"

Response

Stop signal accepted for the current turn.

​
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.