> This page is for version 2025-11-27 (default).
> For other versions, use one of these documentation indexes:
> - 2025-11-27 (default): https://docs.caesar.xyz/2025-11-27/llms.txt
> - 2025-08-08: https://docs.caesar.xyz/2025-08-08/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.caesar.xyz/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.caesar.xyz/_mcp/server.

# Authentication

Caesar uses API keys for authentication. An API key is required to authenticate requests and enable integration with Caesar’s platform.

> **Note**
>
> Get your API key at [your dashboard](https://www.caesar.xyz/api-keys).

## Generate a Caesar API key

1. Visit [your dashboard](https://www.caesar.xyz/api-keys).
2. Create a new API key.
3. Click **Copy** to copy the secret and save it securely. You will not be able to view it again.

## Authenticate your requests

Send your API key as a Bearer token in the HTTP `Authorization` header on every request.

### Example Request

**`JSON`**

```json JSON
curl 'https://api.caesar.xyz/research?page=1&limit=25' \
  -H "Authorization: Bearer $CAESAR_API_KEY" \
  -H "Accept: application/json"
```

## Agent onboarding auth flow

For agent-first onboarding without a dashboard login, use:

1. `POST /agents/auth` with `{ "email": "you@example.com" }`
2. `POST /agents/auth/confirm` with `{ "email": "you@example.com", "code": "123456" }`

The confirm response includes a newly minted `api_key` secret you can use as a Bearer token.