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.
Mark this page