API reference
Handle API errors directly
Use HTTP status, the error string, and optional validation details to decide the next action.
API reference
01
Status codes
Error responses contain an error string. Validation failures can also include a details array. Do not infer access from a resource id because workspace correlation is checked on every read.
- 400
- The request failed validation or required data is missing
- 401
- The bearer credential is missing, invalid, expired, or revoked
- 403
- The owner lacks membership, role access, or key write access
- 404
- The resource does not exist in the authorized workspace
- 429
- The endpoint rejected the request because its limit was reached
- 500
- The server could not complete the operation
- 503
- A configured dependency or integration is unavailable
02
Recovery
Fix 400 responses before retrying. Refresh or replace credentials after 401. Confirm workspace membership and role after 403. Retry 429 and transient 503 responses only after the server supplied delay or a bounded backoff.