Errors

Error shape

Error responses will generally contain statusCode, code, and message fields.

  • statusCode: matches the HTTP error code (e.g. 409)
  • code: a machine-readable code (e.g. IDEMPOTENCY_CONFLICT) used to handle distinct error cases
  • message: a human-readable error

Error shapes may depend on the specific endpoint. See the API reference for details.

HTTP status codes

StatusMeaning
400The request is not valid, or the API key is missing or not valid.
402The payment failed.
403The user role of the API key does not allow the action.
404The object or the route does not exist.
409The request conflicts with the current state of an object.
5xxAn error occurred in Stable.

Error codes

Error codes depend on the specific endpoint. See the API reference for details.