Quickstart - Octave API

Make your first API call

List the agents available in your workspace:

curl -X GET https://api.octavehq.com/api/v2/agents/list \
  -H "Api key: YOUR_API_KEY"

You should see a response like:

{
  "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:

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 — your personas, offerings, segments, the matching Motion ICP, and the relevant 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

Explore Agents

Out-of-the-box agents for prospecting, enrichment, qualification, sequencing, and call prep — all grounded in your Library.

Build a Motion

Motions bind an offering, target market, and narrative angles into the GTM strategy agents execute.

Run Async Workflows

Chain agents into multi-step pipelines you trigger as a single async job.

Learn from Conversations

Pull findings, insights, and reports from every call, email, and deal outcome.

Manage Your Library

Personas, motions, offerings, competitors, objections, proof points — the structured knowledge agents read at runtime.

Connect via MCP

Skip the API and give AI assistants direct access to your workspace.

​Get your API key

​Make your first API call

​Run an agent

​What to build next