quota_exhausted

The message text is shown in the example below.

When it happens

The plan allowance and usage credits cannot pay for the request. The limit field says which cap stopped it: monthly, weekly, session, spend_limit or no_credits.

Example

{
  "error": {
    "type": "insufficient_quota",
    "code": "quota_exhausted",
    "message": "Your plan usage and usage-credit balance are exhausted.",
    "param": null,
    "request_id": "req_6f1c2a9e0b7d4c3a8e5f1b2d",
    "limit": "monthly",
    "resets_at": "2026-11-01T00:00:00.000Z",
    "upgrade_url": "https://syntic.ai/pricing",
    "add_credit_url": "https://syntic.ai/agents/billing#api-topup"
  }
}

How to fix it

• Read limit first: session and weekly clear on their own at resets_at; spend_limit needs an admin to raise the limit; no_credits needs a top-up.
• Turn on usage credits so work continues past the plan allowance.
• Do not retry in a loop; the answer will not change until the cap clears.

Detect it in code

err = resp.json().get("error", {})
if resp.status_code == 402 and err.get("code") == "quota_exhausted":
    log.warning("%s (%s)", err["message"], err["request_id"])  # fix the request; do not retry unchanged

const { error } = await res.json()
if (res.status === 402 && error?.code === 'quota_exhausted') {
  console.warn(error.message, error.request_id) // fix the request; do not retry unchanged
}

Related

• All error codes
• Handle usage limits
• Control costs