Error Reference | Enterprise Router

All proxy errors return JSON with a single error field:

1 {"error": "error message here"}

Error codes

Error	Cause
`missing proxy key`	No `Authorization: Bearer sk-proxy-...` or `x-api-key: sk-proxy-...` header found
`invalid proxy key`	Key not found or hash doesn’t match

Error	Cause	Resolution
`key_revoked`	Key has been revoked	Create a new key
`key_expired`	Key is past its expiry date	Create a new key or extend the expiry
`ip_blocked`	Client IP not in the key’s allowlist	Add the IP to the key’s allowed IPs, or remove IP restrictions
`provider_not_allowed`	Provider not in the key’s allowed providers	Update the key’s provider list
`model_not_allowed`	Model not in the key’s allowed models	Update the key’s model list
`spend_exceeded`	Key has reached its spend limit	Increase the limit or wait for the reset period
`insufficient_credits`	Organization has no remaining credits	Purchase more credits in Settings > Billing
`budget_exceeded`	Organization budget config limit reached	Increase the budget or wait for the period to reset

Error	Cause	Resolution
`rate_limited`	Key has exceeded its RPM limit	Reduce request rate or increase the key’s RPM limit
`organization_rate_limited`	Organization has exceeded its RPM limit	Reduce request rate or increase the org RPM limit

Check the X-RateLimit-Remaining and X-RateLimit-Reset response headers to manage your request rate.

Error	Cause
`unknown provider`	URL path doesn’t start with `/openai/`, `/anthropic/`, or `/gemini/`
`provider not configured`	Provider exists but has no API key configured on the server
`invalid request body`	JSON parsing failed
`model must use provider/model format`	Unified mode: model name couldn’t be resolved to a provider

Error	Cause
`upstream request failed`	The provider didn’t respond after retries (connection error, timeout)

The gateway retries upstream requests with exponential backoff. A 502 means all retry attempts failed.

Error	Cause
`provider temporarily unavailable`	The provider’s circuit breaker is open due to repeated failures
`service_unavailable`	Internal error (e.g., Redis rate limiter unreachable)

The circuit breaker opens when a provider has a high failure rate. It automatically recovers after a cooldown period. Retry after a short wait.

On rate-limited responses, these headers are included:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1712345678

When your organization is approaching its budget limit but requests are still allowed:

X-Budget-Warning: approaching_limit