Beladed Docs
Help Sign in Create account

Developer essentials

Errors

Handle consistent HTTP status codes and machine-readable error details.

Error shape

{
  "error": {
    "code": "invalid_request",
    "message": "A required field is missing.",
    "requestId": "req_example"
  }
}

Status codes

400
The request is invalid or cannot be processed.
401
Authentication is missing or invalid.
403
The credential, account, origin, or permission is not eligible.
404
The public resource does not exist or is not visible to the caller.
409
The operation conflicts with current resource state.
429
The request exceeded the current limit.
5xx
A transient Beladed service failure occurred.

Request IDs

Log the response request ID with your own trace. Include it when contacting support, but do not include credentials or sensitive request bodies.

Type to search the complete public documentation catalog.