{"name":"SubagentStop","slug":"subagentstop","family":"hook","title":"Hook events","noun":"hook event","description":"When a subagent finishes","description_source":"docs","described_by":{"doc":"claude-code\/hooks","title":"Hooks reference"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.163","released_at":"2026-06-04 17:56:01","spans":3}},"aliases":[],"entries":[{"version":"2.1.304","anchor":"uirender-hook-in-the-hooks-module-scan-list","heading":"Plugin mods are now checked for a screen-drawing hook","line":"Claude Code now looks for a `ui.render` hook in plugin mods, and drafts written into the input box can carry decorations","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"hooks-can-now-fail-closed-via-an-on-failure-setting","heading":"Hooks can now block the action when they fail","line":"A new hook option set to `block` makes a hook that fails, times out or returns bad output stop the action it guards","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.286","anchor":"plugin-test-sandbox-allows-more-hooks-and-calls","heading":"Plugin test scans cover SubagentStop hooks, MCP connections and toasts","line":"The plugin test scan list now includes the `SubagentStop` hook and calls to connect to MCP servers and show toasts, and drops two calls","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"subagentstop-hook-event","heading":"SubagentStop hook event","line":"A SubagentStop hook now fires when a subagent finishes, alongside the existing SubagentStart hook","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text, named in this entry"},{"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.163","anchor":"subagentstop-hook-event","heading":"SubagentStop Hook Event","line":null,"released_at":"2026-06-04 17:56:01","reason":"found in this entry's text"},{"version":"2.1.163","anchor":"stop-hook-output-schema-with-additionalcontext","heading":"Stop Hook Output Schema with additionalContext","line":null,"released_at":"2026-06-04 17:56:01","reason":"found in this entry's text"},{"version":"2.1.133","anchor":"reasoning-effort-exposed-to-hooks-and-bash","heading":"Reasoning Effort Exposed to Hooks and Bash","line":null,"released_at":"2026-05-07 20:19:32","reason":"found in this entry's text"},{"version":"2.1.63","anchor":"subagentstart-subagentstop-hook-event-descriptions","heading":"SubagentStart \/ SubagentStop Hook Event Descriptions","line":null,"released_at":"2026-02-28 02:43:42","reason":"found in this entry's text"},{"version":"2.1.26","anchor":"subagentstop-hook-documentation","heading":"SubagentStop Hook Documentation","line":null,"released_at":"2026-01-30 02:13:52","reason":"found in this entry's text"}],"entries_total":11,"docs":[{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":true},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":true},{"source":"claude-code","path":"agent-sdk\/agent-loop","title":"How the agent loop works","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":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"hooks-guide","title":"Automate actions with hooks","documented":false},{"source":"claude-code","path":"sub-agents","title":"Create custom subagents","documented":false},{"source":"claude-code","path":"whats-new\/2026-w23","title":"Week 23 \u00b7 June 1\u20135, 2026","documented":false}],"docs_total":9,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/hook\/subagentstop","family_url":"https:\/\/changelogs.core-directive.com\/reference\/hook.json"}