Authentication
API keys, Bearer authentication and key rotation.
This documentation covers API V1.
On this page
Bearer authentication
All API requests require an API key in the Authorization header. Keys use the sk_ prefix followed by a random secret.
Authorization: Bearer sk_xxxKeeping keys safe
Only the key hash is stored server-side. Never commit keys to source control; use environment variables or a secrets manager. Rotate keys from the dashboard — old keys keep working for a configurable grace period to avoid downtime.
Authentication errors
| Code | HTTP | Description |
|---|---|---|
| UNAUTHORIZED | 401 | Missing or invalid API key. |
| FORBIDDEN | 403 | The key does not have access to this endpoint. |