Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.288 ·

Side queries retry without structured output when a model rejects it

Side queries now retry without the structured-output format when the API rejects output_config.format, and new helpers recognise PDF and format errors

Group of 2 You'll notice Improvements
JSON All of v2.1.288
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Structured OutputsArea: what it touches
ImprovementsKind: in v2.1.288,
ImprovementsSection of the release

What

Side queries are small extra requests Claude Code sends to the model alongside your main conversation. Structured output asks the model to reply in a fixed format, using the output_config.format field. Before this release, side queries decided whether to ask for structured output by checking the model's capabilities in advance. There was no retry if the request was rejected.

Now the side-query path no longer attaches the structured-outputs beta (a preview API feature) based on that capability check. Instead:

  • If the API rejects output_config.format, Claude Code marks the model as not supporting it for the rest of the session.
  • It writes a log line starting [structured-outputs] model and records the retry as a usage event.
  • It sends the request again without the format and without the beta.
  • New helpers recognise the error text output_config.format: extra inputs are not permitted.
  • New helpers also recognise error text saying a model does not support PDF input.

Why

A side query sent to a model that does not accept structured output can now go through on a second try instead of failing. This matters most if you reach models through a gateway or proxy that does not pass the output_config.format field along.

Read from
Names in the bundleoutput_config.format
What the documentation says
output_config.format Claude Code gateway compatibility guide modified, high confidence * The structured-output `output_config.format` field. Requires Claude Code v2.1.287 or later see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is not clear what check now decides whether the format is requested at first.
Anthropic's documentation agreesoutput_config.format on Claude Code gateway compatibility guide

See this entry in the whole of v2.1.288 →

Feedback