AI EngineerGuide

That setting requires the thinking-binding-controls-2026-08-01 value in the anthropic-beta header

Claude API, HTTP 400, invalid_request_error.

Example message:

That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

What it means

The request had no thinking-binding-controls-2026-08-01 beta header. If you did send it, the header didn’t reach the API: a proxy or library may have removed it.

If the request had no beta header, the error message adds this sentence

Fix a thinking block bound to a different conversation (checked 2026-11-20)

If the error still asks for the header, the header didn’t reach the API: a proxy or library might have removed it.

Fix a thinking block bound to a different conversation (checked 2026-11-20)

How to fix it

If you run a library, proxy or gateway: pass anthropic-beta values and thinking.block_binding through as sent, return empty thinking blocks and input_transformations to the caller, and leave role: "system" messages where they are.

A pair of requests that causes it (drop_block set (stopgap)):

Earlier request
{
  "max_tokens": 4096,
  "messages": [
    {
      "content": "Fix the failing test.",
      "role": "user"
    }
  ],
  "model": "claude-fable-5-2",
  "system": "You are a coding agent. Today is 2026-11-18."
}
Next request
{
  "betas": [
    "thinking-binding-controls-2026-08-01"
  ],
  "max_tokens": 4096,
  "messages": [
    {
      "content": "Fix the failing test.",
      "role": "user"
    },
    {
      "content": [
        {
          "signature": "sigA1",
          "thinking": "",
          "type": "thinking"
        },
        {
          "text": "Done.",
          "type": "text"
        }
      ],
      "role": "assistant"
    },
    {
      "content": "Now run the linter.",
      "role": "user"
    }
  ],
  "model": "claude-fable-5-2",
  "system": "You are a coding agent. Today is 2026-11-19.",
  "thinking": {
    "block_binding": {
      "prefix_mismatch_behavior": "drop_block"
    },
    "type": "adaptive"
  }
}

Other prefix-check errors

All errors · Reason codes

Last checked 2026-11-20 against Anthropic's docs.

FAQ

How do I send the header with the SDK?

Call the beta Messages method and pass betas=["thinking-binding-controls-2026-08-01"] (Python) or betas: ["thinking-binding-controls-2026-08-01"] (TypeScript).

Can a gateway strip the header but keep the setting?

It shouldn’t: forwarding the setting without the header gets a 400. Gateways should pass anthropic-beta values and thinking.block_binding through as sent.