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
- Open the Mana app.
- Go to Settings -> API.
- 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:
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:
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.