Skip to main content
422Not retryable

OpenAI 422 Unprocessable Entity

The request parsed but can't be processed semantically — well-formed JSON with contradictory or unusable content.

Most likely causes

  1. 1.Structured-output schema the model can't satisfy
  2. 2.Contradictory parameter combination
  3. 3.Fine-tuning data failing validation

Fix checklist

  • Read the error message — it names the semantic problem
  • Simplify response_format schemas; avoid unsupported JSON Schema keywords
  • Validate training files with the provided validation guidance

Retry guidance

Not retryable — change the request.

// 422 is NOT retryable — surface it and fix the request/config.
const res = await fetch("https://api.openai.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
  },
  body: JSON.stringify(payload),
});
if (res.status === 422) {
  const body = await res.json();
  // Do not retry: log the provider's message — it names the exact problem.
  throw new Error(`OpenAI 422: ${JSON.stringify(body.error ?? body)}`);
}

Provider status page: status.openai.com