> ## Documentation Index
> Fetch the complete documentation index at: https://www.autumn.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## 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

> Intelligence agents for the public web. Hand off a goal, get back finished, sourced data.

Autumn turns a single request into finished, sourced data. Give it a goal and it plans,
searches the web, scrapes pages, cross-checks facts, and returns clean output rows with the
sources behind every value. One API call does the work of a whole research and enrichment
pipeline, and it keeps running in the cloud while you do something else.

Every task gets a durable `task_id`, its own sandbox and agent, task-local files, streamed
events, and output rows you can fetch any time. Start a task, walk away, and come back to
results. When you need changes, continue the same task instead of starting over.

Autumn is one HTTP API. Start with the [Quickstart](/docs/quickstart), read the
[Task API](/docs/api-routes) for every route, or install the [Skill](/docs/skill) to give another
agent the same task surface.

## Quick start

<CodeGroup>
  ```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -sS -X POST "https://api.autumn.ai/task" \
    -H "X-API-Key: $AUTUMN_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Find 20 AI infrastructure startups hiring founding engineers", "clarify": false}'
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  r = requests.post(
      "https://api.autumn.ai/task",
      headers={"X-API-Key": os.environ["AUTUMN_API_KEY"]},
      json={"prompt": "Find 20 AI infrastructure startups hiring founding engineers",
            "clarify": False},
  )
  print(r.json()["task_id"])
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const res = await fetch("https://api.autumn.ai/task", {
    method: "POST",
    headers: {
      "X-API-Key": process.env.AUTUMN_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "Find 20 AI infrastructure startups hiring founding engineers",
      clarify: false,
    }),
  });
  const { task_id } = await res.json();
  ```
</CodeGroup>

The response includes a `task_id`. Keep it. Use it to stream events, continue the task,
read status, and fetch output.

## The model

Autumn exposes one public primitive: a **task**. You hand it a goal; it plans, works the
web, and writes output rows you can fetch any time. One planning flag, `clarify`, decides
whether it may stop to ask a question first.

[The task model](/docs/concepts/tasks) covers this properly: start modes, turns, and why
continuing a task beats starting a new one.

## When to use Autumn

Reach for Autumn when the work is too big or too slow for a single chat turn and you want
it done end to end:

* finding or enriching companies, people, jobs, filings, pages, or contacts
* collecting rows with sources and evidence
* scraping or checking multiple public sources
* continuing a previous task without starting over
* producing output files or task-local artifacts

Avoid Autumn for quick questions your agent can answer directly.

## API key

Create an API key in Autumn settings under **API**, then keep it in an environment
variable:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export AUTUMN_API_KEY=your_key
```

Every request sends it as `X-API-Key` or `Authorization: Bearer`. See
[Authentication](/docs/api-routes#authentication).

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Start a task, wait for it, and read the rows.
  </Card>

  <Card title="Task API" icon="terminal" href="/docs/api-routes">
    HTTP routes for starting, streaming, continuing, and reading tasks.
  </Card>

  <Card title="Skill" icon="plug" href="/docs/skill">
    Install the Autumn skill in Claude Code or any agent that reads skills.
  </Card>

  <Card title="Vibecoding" icon="sparkles" href="/docs/vibecoding">
    Drop Autumn into your coding agent with one link.
  </Card>
</CardGroup>