Errors

Response format and common error codes

All errors follow a consistent JSON format:

JSON
{
    "error": {
        "code": "validation_error",
        "message": "The given data was invalid.",
        "request_id": "req_abc123",
        "errors": {
            "operator_email": [
                "The operator email field is required."
            ]
        }
    }
}

Common Error Codes

|--------|------------| | missing_api_key (401) | No API key provided | | invalid_api_key (401) | Invalid or expired API key | | insufficient_permissions (403) | API key lacks permission | | rate_limit_exceeded (429) | Too many requests | | validation_error (422) | Invalid request data | | not_found (404) | Resource not found | | cannot_cancel (422) | Request not cancellable |