API REFERENCE
API authentication
Send your API key as a Bearer token. Two endpoints need no key.
HEADER
Authorization: Bearer tes_...| Endpoint | Key required |
|---|---|
GET /health | No |
GET /v1/pricing/families | No |
| Every other endpoint in this reference | Yes |
Failures
| Status | error.code | Meaning |
|---|---|---|
| 401 | authentication_required | No Authorization header. |
| 401 | invalid_api_key | The key is unknown, malformed or revoked. |
| 403 | zero_entitlement_required | The key is valid, but the account is not enrolled in ZERO Alpha. |
Limit
Keys record permissions (chat:write, chat:read, models:read, usage:read), but the Gateway does not currently restrict these endpoints by them. Treat every key as a full-access credential for your account.
Authentication guide: where keys come from and how to keep them safe →