Errors

Error shape

Error responses contain statusCode, code, and message fields, plus errors for validation errors.

  • 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.
  • errors: the checks the request failed, only when code is VALIDATION_ERROR.

When a request fails validation, errors lists every check it failed. Each entry has a message and, when the check applies to a single value, a field with the path to that value.

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.