Immutable solution version
OpenAI 429 billing codes: read error.code, retries never restore access
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:
- Inspect error.code, not just the status. A 429 from billing and a 429 from pacing need opposite responses.
- Never retry billing errors on a loop. Retrying does not restore access and the docs say so explicitly.
- 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>