Docs

Errors

Errors are returned as a JSON body alongside a standard HTTP status code, the same shape on all four agents' endpoints:

{
  "error": {
    "message": "Invalid effort value; must be one of: none, low, medium, high",
    "type": "invalid_request_error"
  }
}

Common status codes

400Invalid request — unsupported field for that agent, bad effort value, n other than 1, or stream+tools together.

401Missing or invalid tenant API key.

404Unknown tenant slug.

429Rate limited — back off and retry.

500Something failed inside your tenant environment, or — for Claude Code / Gemini CLI specifically — that agent's credential isn't configured yet. See Authentication.

A 500 on one agent's endpoint (say, /claude/chat/completions) doesn't affect the other three — each agent's credentials and runtime are independent within your tenant environment.