Start a task
Start a durable sandboxed Autumn task from a natural-language prompt. The response returns before the work is complete; store task_id and stream or poll status.
Authorizations
Use Authorization: Bearer YOUR_AUTUMN_API_KEY.
Body
Natural-language task for Autumn.
"Find 10 Series A AI security companies"
Optional single output hint. Include id, kind, path, name, and, for research outputs, schema, schema_order, and target_count.
If true, the agent may ask one blocking planning question before execution. Defaults to false for public API starts.
Optional task-local input filenames or storage paths already available to Autumn.
Optional caller metadata.
Model tier for the task. ranger (default) is the most capable model with the deepest reasoning; scout is faster on a tuned harness. Set at start only and fixed for the life of the task.
ranger, scout "scout"
Response
Task accepted. Store task_id.
"8fab6f34"
"Series A AI security companies"
"research"
A completed or stopped run reports plan; execute means the task is currently working.
plan, execute, deleted "execute"
plan, execute "execute"
Fine-grained state: idle, planning, executing, thinking. A finished task is idle.
"executing"
10
Suggested seconds to wait before polling status again.
5
"/task/8fab6f34"
"/task/8fab6f34/output"
"/task/8fab6f34/stream"