Errors

When to use this page

Use this page when a request fails and you need to decide whether to retry, rotate a key, or contact support.

Missing API key

{
  "error": "Missing API key",
  "message": "Please provide an API key in the x-api-key, x-goog-api-key, or Authorization header"
}

Fix: send Authorization: Bearer $QUOTAFLOW_API_KEY.

Invalid API key

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

Fix: verify environment, key value, and whether the key is active.

Permission denied

{
  "error": {
    "message": "This API key does not have permission to access OpenAI",
    "type": "permission_denied",
    "code": "permission_denied"
  }
}

Fix: ask an admin to enable OpenAI permission for the key.

Capacity queue full

{
  "error": {
    "message": "Capacity queue full",
    "code": "capacity_queue_full"
  }
}

Fix: retry with backoff or ask for a higher package/pool.

Upstream rate limit

{
  "error": {
    "type": "usage_limit_reached",
    "message": "The usage limit has been reached",
    "resets_in_seconds": 3600
  }
}

Fix: retry after the reset time. QuotaFlow also cools the affected upstream account and uses alternate accounts when available.