Reference
Error Codes

Error Codes

Complete reference of all API error codes.

Authentication Errors

CodeHTTP StatusDescription
INVALID_API_KEY401API key is invalid
MISSING_API_KEY401API key header is missing
API_KEY_EXPIRED401API key has expired
API_KEY_REVOKED401API key has been revoked

Authorization Errors

CodeHTTP StatusDescription
INSUFFICIENT_SCOPE403API key lacks required scope
ACCESS_DENIED403Access denied to resource

Resource Errors

CodeHTTP StatusDescription
DEPLOYMENT_NOT_FOUND404Deployment not found
OPERATION_NOT_FOUND404Operation not found
ENVIRONMENT_NOT_FOUND404Environment not found
RESOURCE_CONFLICT409Resource conflict

Request Errors

CodeHTTP StatusDescription
INVALID_REQUEST400Invalid request parameters
VALIDATION_ERROR400Request validation failed

Rate Limit Errors

CodeHTTP StatusDescription
RATE_LIMIT_EXCEEDED429Rate limit exceeded

Server Errors

CodeHTTP StatusDescription
INTERNAL_ERROR500Internal server error
SERVICE_UNAVAILABLE503Service 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