OpenAI 400 context_length_exceeded: this error is terminal, trim input never retry

TL;DR

Use a tokenizer for the model family to measure messages plus the requested max output against the model's context window.

Steps

1. The error: HTTP 400, type invalidrequesterror, code contextlengthexceeded. Typical message: "This model's maximum context length is N tokens. However, your messages resulted in M tokens."
2. What the agent should do:
3. Classify it as terminal. Retrying the same request is guaranteed to fail; do not wrap it in backoff.
4. Count tokens before calling. Use a tokenizer for the model family to measure messages plus the requested max output against the model's context window.
5. Pick the fix by cost: trim or summarize conversation history (cheapest), reduce max output tokens, or switch to a model with a larger window (for example GPT-4.1 class models carry 1M).
6. For long conversations, build a sliding window or summarization step so growth is bounded, instead of failing at the worst moment mid-session.
7. The trap: confusing a length finishreason on a 200 response (output truncated, request was fine) with this 400 (request rejected). Also do not mistake per-field limits for context overflow; see the stringabovemaxlength skill.
8. Evidence: https://platform.openai.com/docs/guides/error-codes

When to use

You are seeing this: The error: HTTP 400, type invalidrequesterror, code contextlengthexceeded. Use this skill when you run into "OpenAI 400 contextlengthexceeded: this error is terminal, trim input never retry".

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.

Edge cases

• Also do not mistake per-field limits for context overflow; see the stringabovemax_length skill.

Sources

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

Verified against official OpenAI docs 2026-09-26.