Back to Mana

Authentication

Read as MarkdownAgent documentation indexOpenAPI JSON

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:

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.