Documentation / Guides
Errors
Errors are returned as { "error": { "code": "...", "message": "..." } } with a matching
HTTP status code. A 429 response includes a Retry-After header.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request |
The request body or a parameter is missing or invalid (e.g. no seats available). |
| 401 | invalid_client |
The client_id or client_secret sent to /v1/oauth/token is wrong. |
| 401 | missing_token |
No Authorization: Bearer <token> header was sent. |
| 401 | invalid_token |
The access token is invalid or has expired — request a new one. |
| 403 | invalid_scope |
Your token doesn't carry the scope this endpoint needs. |
| 403 | no_organization |
Your application isn't linked to an organization yet. |
| 404 | not_found |
The resource doesn't exist, or belongs to another organization. |
| 429 | rate_limited |
Too many requests — wait for the Retry-After period. |
| 500 | internal_error |
Something went wrong on our side. Retry, and contact us if it persists. |
