Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.260 ·

"ask-session" tool policy value deprecated for built-in tools

The 'ask-session' tool policy value is deprecated and now just rewritten to 'ask'.

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaPermissionswhat it touches
KindRemovedin v2.1.260,
You'll notice

The 'ask-session' tool policy value is deprecated and now just rewritten to 'ask'.

Setting a builtinToolPolicy entry to "ask-session" is now a formally deprecated value. It is flagged via BUILTIN_TOOL_POLICY_ASK_SESSION and is rewritten and read back as "ask".

Read from
Names in the bundlebuiltinToolPolicyask-session
What the documentation says
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up ask-session, on Configuration reference. | <span id="builtintoolpolicy" />Built-in tool policy<br />`builtinToolPolicy` | `object` | MDM + Bootstrap<br />Added in 1.8089.0 | — | Approval policy per built-in tool or argument-scoped rule such as Bash(curl \*). “ask” requires user a… third-party/claude-desktop/configuration see the edit
Confirmed since Anthropic's documentation has since written up builtinToolPolicy, on Configuration reference. | <span id="builtintoolpolicy" />Built-in tool policy<br />`builtinToolPolicy` | `object` | MDM + Bootstrap<br />Added in 1.8089.0 | — | Approval policy per built-in tool or argument-scoped rule such as Bash(curl \*). “ask” requires user a… third-party/claude-desktop/configuration see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up builtinToolPolicy, on Configuration reference.

See this entry in the whole of v2.1.260 →

Feedback