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)):
{
"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."
}{
"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
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.