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

# API Reference

> Programmatic access to Asteroid APIs, authentication, and endpoint references.

Use this section to integrate with Asteroid via REST and webhooks.

## Start here

<CardGroup cols={2}>
  <Card title="API Quickstart" icon="play" href="/api-reference/quickstart" horizontal>
    Set up your API key and run your first execution request.
  </Card>

  <Card title="OpenAPI Schema" icon="cloud" href="https://odyssey.asteroid.ai/agents/v2/openapi.yaml" horizontal>
    Inspect paths, request bodies, and response models directly from the source schema.
  </Card>
</CardGroup>

## Authentication

Include your API key in requests with the `X-Asteroid-Agents-Api-Key` header.

```bash theme={null}
curl -H "X-Asteroid-Agents-Api-Key: $ASTEROID_API_KEY" \
  "https://odyssey.asteroid.ai/agents/v2/agents"
```

## Specs

* Core API OpenAPI: `https://odyssey.asteroid.ai/agents/v2/openapi.yaml`
* Webhooks OpenAPI: `https://odyssey.asteroid.ai/webhooks/openapi.json`