Errors

Cedius uses HTTP status codes plus a consistent JSON error envelope.

json

{
  "error": {
    "code": "validation_error",
    "message": "One or more fields are invalid.",
    "details": [
      {
        "field": "email",
        "message": "Enter a valid email address."
      }
    ],
    "request_id": "req_71fa2c"
  }
}

Status	Code	Meaning
`400`	`invalid_request`	Request format is invalid.
`401`	`authentication_failed`	API key is missing or invalid.
`403`	`permission_denied`	Caller lacks permission.
`404`	`resource_not_found`	Resource does not exist.
`409`	`conflict`	Request conflicts with current state.
`409`	`duplicate_resource`	A uniqueness rule would be violated.
`422`	`validation_error`	Validation failed.
`429`	`rate_limit_exceeded`	Request limit was exceeded.
`500`	`internal_error`	Unexpected server failure.

When troubleshooting, include the X-Request-ID but never a secret API key.

Errors ​

Errors