Errors
Errors use standard HTTP status codes and a consistent JSON body.
{
"error": {
"code": "unauthorized",
"message": "The API token is missing or invalid.",
"request_id": "req_8F3K2"
}
}
Status codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | The request was malformed |
| 401 | Missing or invalid token |
| 403 | Authenticated, but not allowed |
| 404 | No such resource |
| 429 | Rate limited (see Retry-After) |
| 500 | Something went wrong on our side |
Always log the request_id. Quoting it when you contact support makes issues far faster to trace.