Zaira Auth
All requests require the x-api-key header for authentication (except /health).
API key
Include your API key in every request:
x-api-key: your-api-keyContact the Zaira team to receive your API key.
User identity
After authentication, most endpoints require user identification. Use the user_uuid returned from /initiate:
x-user-uuid: <user-uuid>Endpoint requirements
| Endpoint | API key | User identity |
|---|---|---|
POST /initiate | Required | Not required |
POST /ask | Required | Required |
POST /ask/stream | Required | Required |
POST /check-execution | Required | Required |
GET /sessions | Required | Required |
GET /info | Required | Not required |
/webhooks | Required | Not required |
GET /health | Not required | Not required |
The /initiate endpoint returns a user_uuid that you must use for all subsequent requests.
Updated 28 days ago