AI EngineerGuide

block_binding: Extra inputs are not permitted

Claude API, HTTP 400, invalid_request_error.

Example message:

thinking.block_binding: Extra inputs are not permitted

What it means

The API didn’t accept thinking.block_binding: the beta header didn’t arrive, or thinking is off (disabled or between_tools).

A different error, ending block_binding: Extra inputs are not permitted, means the same, or that thinking is off.

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.

With thinking off (disabled or between_tools), you can’t use drop_block. Remove the block the error names and every thinking and redacted_thinking block after it (all of them if your history has role: "system" messages or two same-role messages in a row), keep every other block, and send again. Don’t put the removed blocks back.

A pair of requests that causes it (drop_block with thinking disabled):

Earlier request
{
  "max_tokens": 4096,
  "messages": [
    {
      "content": "Fix the failing test.",
      "role": "user"
    }
  ],
  "model": "claude-fable-5-2",
  "system": "You are a coding agent."
}
Next request
{
  "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.",
  "thinking": {
    "block_binding": {
      "prefix_mismatch_behavior": "drop_block"
    },
    "type": "disabled"
  }
}

Other prefix-check errors

All errors · Reason codes

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

FAQ

Can I use drop_block with thinking disabled?

No. "drop_block" needs "adaptive" thinking. With thinking off, remove the invalid thinking by hand instead.