# Autumn AI

> Intelligence agents for the public web. Hand Autumn a goal and get back finished, sourced data, through the API and Skill.

> ## Agent Instructions
> Autumn AI (autumn.ai) is a people and company intelligence API, a separate company from useautumn.com (billing software); no billing-product routes exist here.
> Base URL https://api.autumn.ai. Auth on every request: `X-API-Key: <key>` or `Authorization: Bearer <key>`. Plain HTTP + JSON. Schemas: https://www.autumn.ai/docs/openapi.json. Every docs page is Markdown at its URL plus `.md`.

- [Introduction](https://www.autumn.ai/docs/index.md): Intelligence agents for the public web. Hand off a goal, get back finished, sourced data.
- [Quickstart](https://www.autumn.ai/docs/quickstart.md): Start your first Autumn task over HTTP and read the rows it produces.
- [Principles](https://www.autumn.ai/docs/principles.md): The design decisions behind Autumn, and what they buy you.
- [FAQ](https://www.autumn.ai/docs/faq.md): Short answers to the questions that come up while integrating Autumn.
- [The task model](https://www.autumn.ai/docs/concepts/tasks.md): Autumn exposes one primitive: a task. Everything else is a way to start, watch, or read one.
- [Task lifecycle](https://www.autumn.ai/docs/concepts/lifecycle.md): The states a task moves through, and how to tell when it has actually finished.
- [Outputs and sources](https://www.autumn.ai/docs/concepts/outputs.md): What a task produces: output kinds, rows built from cells, and the sources behind every value.
- [Model tiers](https://www.autumn.ai/docs/concepts/model-tiers.md): Ranger and Scout: choosing a tier, and when the choice is locked in.
- [Structured output](https://www.autumn.ai/docs/guides/structured-output.md): Declare the exact columns a task should return, and read them back as typed rows.
- [Live messages](https://www.autumn.ai/docs/guides/streaming.md): Stream Server-Sent Events as the agent plans and executes.
- [Follow-up tasks](https://www.autumn.ai/docs/guides/follow-up.md): Continue the same task with new instructions instead of starting over.
- [Human in the loop](https://www.autumn.ai/docs/guides/human-in-the-loop.md): Let the agent ask a clarifying question, or hand control back and forth.
- [Attach a CSV](https://www.autumn.ai/docs/guides/file-uploads.md): Upload a CSV, text, or markdown file and enrich every row in a task.
- [Writing task prompts](https://www.autumn.ai/docs/best-practices/prompting.md): How to phrase a task so the agent infers the right work, and what to pin down explicitly.
- [Skill](https://www.autumn.ai/docs/skill.md): Install the Autumn Skill for agent workflow guidance.
- [Vibecoding](https://www.autumn.ai/docs/vibecoding.md): Drop Autumn into your coding agent with one link.
- [API overview](https://www.autumn.ai/docs/api-routes.md): Base URL, authentication, request fields, and the full route map for the Task API.
- [Errors](https://www.autumn.ai/docs/api/errors.md): One error body. Branch on `error`. Retry when `retryable` is true.
- [Rate limits](https://www.autumn.ai/docs/api/rate-limits.md): Where Autumn applies rate limits, the numbers, and how to handle a 429.
- [Start a task](https://www.autumn.ai/docs/api-reference/tasks/start-a-task.md): Start a task from a prompt. Returns at once: store task_id, then stream or poll. Pass task_id to send the prompt to an existing task.
- [Start a task and stream](https://www.autumn.ai/docs/api-reference/tasks/start-a-task-and-stream.md): Start a task from a prompt and stream the turn.
- [Start from a task spec](https://www.autumn.ai/docs/api-reference/tasks/start-from-a-task-spec.md): Start from a task.json spec with no planning turn. Without task, same as POST /task.
- [Start from a task spec and stream](https://www.autumn.ai/docs/api-reference/tasks/start-from-a-task-spec-and-stream.md): Start from a task spec and stream the turn.
- [Continue a task](https://www.autumn.ai/docs/api-reference/tasks/continue-a-task.md): Send a message to the task. Queued (202) unless wait is true (200).
- [Continue a task and stream](https://www.autumn.ai/docs/api-reference/tasks/continue-a-task-and-stream.md): Send a message to the task and stream the turn.
- [Execute a task](https://www.autumn.ai/docs/api-reference/tasks/execute-a-task.md): Produce output from the current spec. Queued (202) unless wait is true (200).
- [Execute a task and stream](https://www.autumn.ai/docs/api-reference/tasks/execute-a-task-and-stream.md): Produce output and stream the turn.
- [Stop a task](https://www.autumn.ai/docs/api-reference/tasks/stop-a-task.md): Stop the turn, drop queued messages, return the task to plan. Outputs stay readable.
- [Get task workflow](https://www.autumn.ai/docs/api-reference/tasks/get-task-workflow.md): The task workflow and route map.
- [Get task metaprompt](https://www.autumn.ai/docs/api-reference/tasks/get-task-metaprompt.md): The task spec schema, output kinds, and metaprompt for caller-side agents.
- [List tasks](https://www.autumn.ai/docs/api-reference/tasks/list-tasks.md): Recent tasks, newest first.
- [Get task status](https://www.autumn.ai/docs/api-reference/tasks/get-task-status.md): Status, spec and the last 100 events. Poll only without a stream; GET /task/{task_id}/state is cheaper.
- [Get task state](https://www.autumn.ai/docs/api-reference/tasks/get-task-state.md): Whether a turn is running and what is queued. This is the status_url on every task.
- [Stream task events](https://www.autumn.ai/docs/api-reference/tasks/stream-task-events.md): Live events for a task. Resume with Last-Event-ID or after.
- [Get task output](https://www.autumn.ai/docs/api-reference/outputs/get-task-output.md): Rows from the active output. Partial rows are readable during a run. Page with limit and cursor: the body carries _next_cursor while rows remain.
- [List task outputs](https://www.autumn.ai/docs/api-reference/outputs/list-task-outputs.md): The named output artifacts of a task.
- [Get a named output](https://www.autumn.ai/docs/api-reference/outputs/get-a-named-output.md): Rows from one named output. Page with limit and cursor: the body carries _next_cursor while rows remain.
- [Get credits](https://www.autumn.ai/docs/api-reference/credits/get-credits.md): Credit balance.
- [Create a draft task](https://www.autumn.ai/docs/api-reference/uploads/create-a-draft-task.md): An empty task to attach uploads to. Start it with POST /task and its task_id.
- [Presign a file upload](https://www.autumn.ai/docs/api-reference/uploads/presign-a-file-upload.md): Presign a .csv, .txt, .md or .markdown upload. PUT the bytes to upload_url with no auth headers, then POST /validate-upload.
- [Validate an uploaded file](https://www.autumn.ai/docs/api-reference/uploads/validate-an-uploaded-file.md): Validate an upload and return the filename for input_files. CSV becomes JSONL: delimiter detected, duplicate and blank headers renamed, extra cells kept as column_N, a user _row_id column becomes _row_id_2.
- [Cookbook](https://www.autumn.ai/docs/cookbook/overview.md): Complete jobs, built by composing the API: pipelines, workers, agents, and UIs.
- [Build a reviewed list](https://www.autumn.ai/docs/cookbook/reviewed-list.md): Compose a declared schema, live events, human review, and continuation into one repeatable job.
- [Run Autumn from a background worker](https://www.autumn.ai/docs/cookbook/background-worker.md): Start tasks from a queue, survive restarts, and land the rows in your own store.
- [Stream a task into your UI](https://www.autumn.ai/docs/cookbook/live-dashboard.md): Show users live agent progress, then refresh the table when the turn ends.
- [Let an agent drive Autumn](https://www.autumn.ai/docs/cookbook/agent-driven.md): Give a coding agent the whole task surface: generate a spec, start it, and manage the loop.

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)
- [openapi](https://api.autumn.ai/openapi.json)

## Optional

- [Start for free](https://platform.autumn.ai)
- [Articles](https://www.autumn.ai/resources/articles)
- [Changelog](https://www.autumn.ai/changelog)