# Authentication Mana public API requests authenticate with API keys created in the Mana web app. ## API Key Authentication Use API keys for normal public API calls, such as creating conversations, polling status, streaming events, and downloading artifacts. ### Create a Key 1. Open the Mana app. 2. Go to **Settings -> API**. 3. Create a key and store the raw value securely. Mana only shows the raw key once. ### Send the Key Include the key in the `X-API-Key` header. The examples below read it from the `MANA_API_KEY` environment variable: ```bash curl https://backend-alpha.mana.ai/api/v1/conversations \ -H "X-API-Key: $MANA_API_KEY" ``` If your client can only send an `Authorization` header, send the key as a bearer token instead. Mana treats a bearer token that starts with `mana_` as an API key: ```bash curl https://backend-alpha.mana.ai/api/v1/conversations \ -H "Authorization: Bearer $MANA_API_KEY" ``` A missing, revoked or expired key returns `401`. ### Permissions API keys are tied to the user and organization that created them. Requests made with a key can only access data and workflows available to that account context. ## API Key Management Create, list, and revoke API keys from **Settings -> API** in the Mana web app. API keys cannot be used to manage API keys: the `/api/v1/api-keys` endpoints accept only a signed-in web session and return `403` for an API key, so a leaked key cannot create or revoke other keys. ## Unauthenticated Endpoints `GET /api/v1/health` is unauthenticated and should be called without `Authorization` or `X-API-Key` headers. ## Rotation Revoke stale or exposed keys from **Settings -> API**, then create a replacement key for your integration.