Skip to main content
BehavIQ returns JSON errors with a code and message. The most common status codes are:
  • 401 missing or invalid API key
  • 402 insufficient credits
  • 403 key is not allowed to call that endpoint
  • 429 rate limited
  • 5xx transient server error

​
Retry guidance

Retry these:
  • 429
  • 500
  • 502
Do not blindly retry these:
  • 401
  • 402
  • 403
  • 404
Those usually need a request or config fix.

​
Example error

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your workspace does not have enough credits."
  }
}