{"name":"permissionDecision","slug":"permissiondecision","family":"setting","title":"Settings keys","noun":"settings key","description":"Hooks for tool calls served to a cloud session can be held instead of run, turning the call into an ask.","description_source":"entry","described_by":{"version":"2.1.242","anchor":"hooks-are-held-rather-than-run-for-tool-calls-served-to-a-cl"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.277","released_at":"2026-09-18 16:22:26","spans":3}},"aliases":[],"entries":[{"version":"2.1.293","anchor":"hook-output-validation-errors-now-carry-a-reason-string","heading":"Malformed hook replies now produce errors with a named reason","line":"Hook output with an unknown permission decision or the wrong event name now raises an error that states which of the two went wrong","released_at":"2026-10-07 17:18:04","reason":"found in this entry's text"},{"version":"2.1.288","anchor":"hook-output-with-permissiondecision-ask-detected","heading":"Claude Code picks out hook replies that ask for your permission","line":"Claude Code now singles out hook output whose permission decision is \"ask\", unless the hook also said to stop","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text, named in this entry"},{"version":"2.1.277","anchor":"pretooluse-hook-warnings-identify-the-tool-generically-not","heading":"PreToolUse hook warnings identify the tool generically, not by literal name","line":"PreToolUse hook warnings now name tools generically instead of by their literal name","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.251","anchor":"new-premodelswitch-and-postmodelswitch-hooks","heading":"New PreModelSwitch and PostModelSwitch hooks","line":"New PreModelSwitch and PostModelSwitch hooks let you gate or annotate every model change.","released_at":"2026-08-28 15:34:26","reason":"named in this entry, found in this entry's text"},{"version":"2.1.248","anchor":"hook-schema-failures-now-print-the-exact-field-a-template-an","heading":"Hook schema failures now print the exact field, a template, and which tool failed","line":"A bad hook response now shows the exact failing field, the output and a template.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"hooks-are-held-rather-than-run-for-tool-calls-served-to-a-cl","heading":"Hooks are held rather than run for tool calls served to a cloud session","line":"Hooks for tool calls served to a cloud session can be held instead of run, turning the call into an ask.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"}],"entries_total":6,"docs":[{"source":"claude-code","path":"agent-sdk\/claude-code-features","title":"Use Claude Code features in the SDK","documented":false},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":false},{"source":"claude-code","path":"agent-sdk\/python","title":"Agent SDK reference - Python","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":false},{"source":"claude-code","path":"hooks-guide","title":"Automate actions with hooks","documented":false},{"source":"claude-code","path":"whats-new\/2026-w14","title":"Week 14 \u00b7 March 30 \u2013 April 3, 2026","documented":false}],"docs_total":7,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/permissiondecision","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}