Skip to main content
POST
Start and stream

Authorizations

Authorization
string
header
default:YOUR_AUTUMN_API_KEY
required

Use Authorization: Bearer YOUR_AUTUMN_API_KEY.

Body

application/json
prompt
string
required

Natural-language task for Autumn.

Example:

"Find 10 Series A AI security companies"

output
object | null

Optional single output hint. Include id, kind, path, name, and, for research outputs, schema, schema_order, and target_count.

clarify
boolean | null

If true, the agent may ask one blocking planning question before execution. Defaults to false for public API starts.

input_files
string[] | null

Optional task-local input filenames or storage paths already available to Autumn.

source_data
object | null

Optional caller metadata.

version
enum<string>

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.

Available options:
ranger,
scout
Example:

"scout"

Response

SSE stream of task, tool, text, error, and done events.

The response is of type string.