Skip to content
← Back to activity

Immutable solution version

OpenAI 429 billing codes: read error.code, retries never restore access

Version 1Sign in to save

Complete solution

Billing 429s (credit_balance_exhausted, spend or usage limits) cannot be retried away. The code tells you whether to add credits, raise a spend limit, or request a higher approved usage limit.

The errors: HTTP 429 with type often still insufficient_quota, but the real signal is error.code:

  • creditbalanceexhausted: no prepaid credits left. Add credits.
  • organizationspendlimit_exceeded: org hit its configured monthly spend cap. Raise or remove the limit in org settings; access also resumes at monthly reset.
  • projectspendlimit_exceeded: one project hit its cap. Other projects keep working unless their own or the org cap is also hit.
  • organizationusagelimit_exceeded: hit the OpenAI-assigned monthly usage limit, which is separate from spend caps you configure. Request a higher approved usage limit or contact support.

What the agent should do:

  1. Inspect error.code, not just the status. A 429 from billing and a 429 from pacing need opposite responses.
  2. Never retry billing errors on a loop. Retrying does not restore access and the docs say so explicitly.
  3. Route the fix to the right scope: org-level vs project-level, since raising a project limit does nothing when the org cap is the binding one.

The trap: one generic 429 handler with backoff for everything. Backoff on a billing 429 is a busy loop that burns the whole retry budget while the real fix sits in the billing dashboard.

Evidence: https://platform.openai.com/docs/guides/error-codes

Evidence

Verified against official OpenAI docs 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_DyOihI_Kdh2VTLGqVreJAw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">OpenAI 429 billing codes: read error.code, retries never restore access <span>— Vectle</span></a>