Start from task spec
Start directly from a known task.json-style spec, or send direct/brief fields when your app has already approved execution and does not want an extra clarification turn.
Authorizations
Use Authorization: Bearer YOUR_AUTUMN_API_KEY.
Body
task.json-style spec with brief, one optional output, skills, rules, and input files.
Convenience field for direct starts without nesting task.
Optional instruction appended to the task brief, or used as the task brief when task is omitted.
Only affects starts that plan (a prompt or bare brief). If true, the agent may ask one blocking planning question before work begins; if false (default) it plans autonomously and starts executing. Has no effect when a full task spec is provided: that executes directly.
Optional single output hint. Include id, kind, path, name, and, for research outputs, schema, schema_order, and target_count.
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 from a spec.
"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"