permissionDecision
A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
Hooks for tool calls served to a cloud session can be held instead of run, turning the call into an ask.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.242.
In the changelogs
6Releases whose published page names permissionDecision.
-
v2.1.293
Malformed hook replies now produce errors with a named reason
Hook output with an unknown permission decision or the wrong event name now raises an error that states which of the two went wrong
found in this entry's text
-
v2.1.288
Claude Code picks out hook replies that ask for your permission
Claude Code now singles out hook output whose permission decision is "ask", unless the hook also said to stop
found in this entry's text, named in this entry
-
v2.1.277
PreToolUse hook warnings identify the tool generically, not by literal name
PreToolUse hook warnings now name tools generically instead of by their literal name
found in this entry's text
-
v2.1.251
New PreModelSwitch and PostModelSwitch hooks
New PreModelSwitch and PostModelSwitch hooks let you gate or annotate every model change.
named in this entry, found in this entry's text
-
v2.1.248
Hook schema failures now print the exact field, a template, and which tool failed
A bad hook response now shows the exact failing field, the output and a template.
found in this entry's text
-
v2.1.242
Hooks are held rather than run for tool calls served to a cloud session
Hooks for tool calls served to a cloud session can be held instead of run, turning the call into an ask.
found in this entry's text
First cited
3The earliest release whose published evidence quoted permissionDecision was v2.1.277, 18 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.