Skip to main content
POST
Execute a task

Authorizations

Authorization
string
header
default:YOUR_AUTUMN_API_KEY
required

Use Authorization: Bearer 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

Optional instruction to include with execution.

Response

Task accepted for execution.

task_id
string
Example:

"8fab6f34"

name
string | null
Example:

"Series A AI security companies"

type
string | null
Example:

"research"

status
enum<string>

A completed or stopped run reports plan; execute means the task is currently working.

Available options:
plan,
execute,
deleted
Example:

"execute"

phase
enum<string> | null
Available options:
plan,
execute
Example:

"execute"

activity
string | null

Fine-grained state: idle, planning, executing, thinking. A finished task is idle.

Example:

"executing"

output_count
integer | null
Example:

10

poll_after_s
integer

Suggested seconds to wait before polling status again.

Example:

5

status_url
string
Example:

"/task/8fab6f34"

output_url
string
Example:

"/task/8fab6f34/output"

stream_url
string
Example:

"/task/8fab6f34/stream"