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 whencodeisVALIDATION_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
| Status | Meaning |
|---|---|
| 400 | The request is not valid, or the API key is missing or not valid. |
| 402 | The payment failed. |
| 403 | The user role of the API key does not allow the action. |
| 404 | The object or the route does not exist. |
| 409 | The request conflicts with the current state of an object. |
| 5xx | An error occurred in Stable. |
Error codes
Error codes depend on the specific endpoint. See the API reference for details.
