Error Codes
The API uses standard HTTP status codes and returns errors in a consistent JSON format.
Error Response Format
{
"error": {
"code": "not_found",
"message": "The requested resource was not found",
"status": 404
}
}
Common Error Codes
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | The request body is malformed or missing required fields |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key lacks required permissions |
| 404 | not_found | The requested resource does not exist |
| 409 | conflict | Resource already exists or state conflict |
| 422 | validation_error | Request failed validation |
| 429 | rate_limited | Too many requests |
| 500 | internal_error | An unexpected error occurred |