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

# Quickstart

> Make your first Octave API call in under 5 minutes. Get your API key, run an agent, and see results.

## Get your API key

<Steps>
  <Step title="Log in to your Octave dashboard">
    Go to [app.octavehq.com](https://app.octavehq.com) and sign in. If you don't have an account, [start for free](https://octavehq.com/pricing).
  </Step>

  <Step title="Copy your API key">
    Navigate to **Settings > API Keys** and copy your workspace API key. Each workspace has a unique key.
  </Step>
</Steps>

## Make your first API call

List the agents available in your workspace:

```bash theme={null}
curl -X GET https://api.octavehq.com/api/v2/agents/list \
  -H "Api key: YOUR_API_KEY"
```

You should see a response like:

```json theme={null}
{
  "metadata": {
    "hasNext": false,
    "total": 9
  },
  "data": [
    {
      "type": "PROSPECTOR",
      "name": "Prospector Agent",
      "description": "Research and qualify prospects against your ICP"
    }
  ]
}
```

## Run an agent

Once you have your agent list, run one. Here's how to enrich a company:

```bash theme={null}
curl -X POST https://api.octavehq.com/api/v2/agents/enrich-company/run \
  -H "Api key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Stripe",
    "companyUrl": "https://stripe.com"
  }'
```

The response includes firmographic data, product fit analysis, and a confidence score based on your ICP definition. The agent reads your [Library](/concepts/library) — your [personas](/concepts/personas), [offerings](/concepts/offerings), [segments](/concepts/segments), the matching [Motion ICP](/concepts/motions#motion-icps), and the relevant [proof points](/concepts/proof-points) — to evaluate how well this company fits your ideal customer profile. Every agent call is grounded in your actual GTM strategy, not generic enrichment data.

## What to build next

<CardGroup cols={2}>
  <Card title="Explore Agents" icon="robot" href="/concepts/agents">
    Out-of-the-box agents for prospecting, enrichment, qualification, sequencing, and call prep — all grounded in your Library.
  </Card>

  <Card title="Build a Motion" icon="rocket" href="/concepts/motions">
    Motions bind an offering, target market, and narrative angles into the GTM strategy agents execute.
  </Card>

  <Card title="Run Async Workflows" icon="arrows-spin" href="/concepts/workflows">
    Chain agents into multi-step pipelines you trigger as a single async job.
  </Card>

  <Card title="Learn from Conversations" icon="chart-line" href="/concepts/analytics">
    Pull findings, insights, and reports from every call, email, and deal outcome.
  </Card>

  <Card title="Manage Your Library" icon="book" href="/concepts/library">
    Personas, motions, offerings, competitors, objections, proof points — the structured knowledge agents read at runtime.
  </Card>

  <Card title="Connect via MCP" icon="plug" href="/mcp/overview">
    Skip the API and give AI assistants direct access to your workspace.
  </Card>
</CardGroup>