Start from task spec and stream
Start directly from a known task spec and stream live server-sent events for the current 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
SSE stream of task, tool, text, error, and done events.
The response is of type string.