Errors
The API uses standard HTTP status codes and returns a consistent JSON error format.Error response format
All error responses follow this structure:Status codes
For security, requesting a resource that exists but belongs to another organization returns
404 (not 403). This prevents ID enumeration attacks.Handling errors
Tips
- Always check
successin the response body, not just the HTTP status - Log the full error response in production for debugging
- Implement retries for
429and5xxerrors with exponential backoff - Don’t retry
400,401,403, or404errors — they require code or configuration changes

