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

# Authentication

> Authenticate requests to the Perso AI Platform with an API key.

## API keys

Most Perso AI Platform endpoints authenticate with an API key passed as a request header.

<Card title="Get your API Key" icon="key" horizontal>
  Create and manage keys from your account on [platform.perso.ai](https://platform.perso.ai).
</Card>

<Warning>
  Keep API keys secret. Don't embed them in client-side code or commit them to version control. For user-facing apps, proxy requests through your backend.
</Warning>

## Sending your key

Pass the key in the `PersoPlatform-APIKey` header:

```bash theme={null}
curl https://platform.perso.ai/api/... \
  -H "PersoPlatform-APIKey: YOUR_API_KEY"
```

The interactive playground in each product tab adds this header for you once you enter your key.

## Header reference

| Header                 | Used for                                                         |
| ---------------------- | ---------------------------------------------------------------- |
| `PersoPlatform-APIKey` | Primary Platform API key — use this by default.                  |
| `xi-api-key`           | ElevenLabs-compatible SDKs — pass your Perso key as this header. |
| `sessionid` (cookie)   | Browser/session auth for first-party console requests.           |

<Note>
  Each endpoint lists the exact scheme it accepts under its **Authorizations** section in the reference. When in doubt, start with `PersoPlatform-APIKey`.
</Note>