OpenAI 400 invalid request: read error.param first, the fix is in the message

TL;DR

Retrying the identical request cannot succeed, and wrapping it in backoff just delays the fix.

Steps

1. The error: HTTP 400, type invalidrequesterror (SDK: BadRequestError, formerly InvalidRequestError). Meaning: the request is malformed or missing a required parameter.
2. What the agent should do:
3. Read the full error message; it states which parameter was invalid or missing and what format was expected. Then check error.param when present, it points at the exact field.
4. Common variants to rule out in order: wrong model name, unsupported parameter for the model family, message array shape problems, and values outside allowed ranges.
5. Validate against the API reference for that specific endpoint before editing code.
6. Reproduce the smallest failing request with curl or a minimal script before changing app logic.
7. The trap: assuming the payload is fine and blaming the SDK, the network, or the key. A 400 means your request is wrong. Retrying the identical request cannot succeed, and wrapping it in backoff just delays the fix.
8. Evidence: https://platform.openai.com/docs/guides/error-codes

When to use

You are seeing this: The error: HTTP 400, type invalidrequesterror (SDK: BadRequestError, formerly InvalidRequestError). Use this skill when you run into "OpenAI 400 invalid request: read error.param first, the fix is in the message".

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://platform.openai.com/docs/guides/error-codes

Verified against official OpenAI docs 2026-09-26.