Authentication
All API requests use Bearer token authentication with an API key.Headers
Send your API key in theAuthorization header:
sk_ (e.g. sk_live_...).
Example
Security best practices
| Practice | Description |
|---|---|
| Server-side only | Never embed API keys in client apps or frontend code. Call the API from your backend and keep the key in env vars or a secret manager. |
| Rotate keys | Rotate keys periodically and when someone leaves the team. Create a new key in the dashboard and update your services, then revoke the old key. |
| Least privilege | Use separate keys per environment (e.g. dev vs production) so a compromise is limited in scope. |
| No source control | Do not commit keys to Git. Use .env (and add it to .gitignore) or a secrets backend. |
Invalid or missing key
- Missing header — Responses return
401 Unauthorizedwith a message that a valid API key is required. - Invalid key — Same
401; the key may be revoked, malformed, or from another account.
Authorization: Bearer sk_....