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.