Error Format
HTTP Status Codes
Common Errors
401 - Invalid Token
403 - Missing Scope
429 - Rate Limited
Retry-After seconds.
402 - Insufficient Credits
Rate Limits
Retry Logic
Implement exponential backoff for 429 and 5xx errors:Best Practices
- Check status before parsing — Don’t assume success
- Implement retries — For 429 and 5xx errors
- Log error details — Include
detailmessage for debugging - Show user-friendly messages — Don’t expose raw errors to users
- Monitor error rates — Alert on spikes
FAQ
What format do Cuadra AI errors use?
All errors follow RFC 7807 Problem Details format withtype, title, status, and detail fields.
How should I handle rate limits (429)?
Implement exponential backoff. Wait the time specified inRetry-After header, then retry. See retry logic examples above.
What does “insufficient_credits” mean?
Your organization has run out of credits. Purchase more at dashboard.cuadra.ai or upgrade your plan.Related
Authentication
Fix auth errors
Credits
Handle credit errors