Error Codes
Complete reference of all API error codes.
Authentication Errors
| Code | HTTP Status | Description |
|---|---|---|
INVALID_API_KEY | 401 | API key is invalid |
MISSING_API_KEY | 401 | API key header is missing |
API_KEY_EXPIRED | 401 | API key has expired |
API_KEY_REVOKED | 401 | API key has been revoked |
Authorization Errors
| Code | HTTP Status | Description |
|---|---|---|
INSUFFICIENT_SCOPE | 403 | API key lacks required scope |
ACCESS_DENIED | 403 | Access denied to resource |
Resource Errors
| Code | HTTP Status | Description |
|---|---|---|
DEPLOYMENT_NOT_FOUND | 404 | Deployment not found |
OPERATION_NOT_FOUND | 404 | Operation not found |
ENVIRONMENT_NOT_FOUND | 404 | Environment not found |
RESOURCE_CONFLICT | 409 | Resource conflict |
Request Errors
| Code | HTTP Status | Description |
|---|---|---|
INVALID_REQUEST | 400 | Invalid request parameters |
VALIDATION_ERROR | 400 | Request validation failed |
Rate Limit Errors
| Code | HTTP Status | Description |
|---|---|---|
RATE_LIMIT_EXCEEDED | 429 | Rate limit exceeded |
Server Errors
| Code | HTTP Status | Description |
|---|---|---|
INTERNAL_ERROR | 500 | Internal server error |
SERVICE_UNAVAILABLE | 503 | Service temporarily unavailable |
Error Response Format
All errors follow this format:
{
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"operation_id": "op_xxx" // For async operations
}
}Related Topics
- API: Errors - Error handling guide
- API: Rate Limits - Rate limiting