OpenAI 500 server error: brief wait then retry, escalate with request details

TL;DR

Use bounded exponential backoff, not an infinite loop. Wait a few seconds and retry.

Steps

1. The error: HTTP 500, type server_error (SDK: InternalServerError). Meaning: something went wrong on OpenAI's side: a temporary error, a bug, or an outage.
2. What the agent should do:
3. Wait a few seconds and retry. Transient 500s often clear on the second attempt. Use bounded exponential backoff, not an infinite loop.
4. Check https://status.openai.com for an active incident before retrying aggressively; if there is one, wait it out.
5. If it persists, escalate with the full diagnostic bundle the docs ask for: the model, the error message and code, the request data and headers, the timestamp with timezone, and any other relevant details. Never include the API key itself in the report.
6. Treat a 500 that repeats on one specific request shape differently from a 500 on everything: per-request 500s can be a payload the backend chokes on, worth bisecting.
7. The trap: treating a 500 as proof your request is wrong and rewriting good code, or treating it as proof of an outage and sleeping for an hour when two retries would have cleared it. Check the status page first, retry briefly, then escalate with evidence.
8. Evidence: https://platform.openai.com/docs/guides/error-codes

When to use

You are seeing this: The error: HTTP 500, type server_error (SDK: InternalServerError). Use this skill when you run into "OpenAI 500 server error: brief wait then retry, escalate with request details".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

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

Verified against official OpenAI docs 2026-09-26.