{"name":"interrupt","slug":"interrupt","family":"setting","title":"Settings keys","noun":"settings key","description":"Send interrupt with cancel_queued true to stop the current turn and everything queued behind it.","description_source":"entry","described_by":{"version":"2.1.219","anchor":"sdk-interrupt-can-now-cancel-everything-queued-in-one-round-"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.286","anchor":"send-task-message-control-request-added-sessionwriters-stub","heading":"SDK control request list gains send_task_message","line":"A request named send_task_message joins interrupt and stop_task in Claude Code's list of control requests","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-engine-lifecycle-for-failed-turn-setup-and-an-abandonm","heading":"SDK engine: lifecycle for failed turn setup, and an abandonment sweep","line":"The SDK engine now reports turns that failed to start and cleans up waiting turns when it closes","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"new-abort-reason-permission-stop","heading":"New abort reason: permission-stop","line":"New 'permission-stop' abort reason lets Claude Code cleanly cancel work when a permission prompt is stopped","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"control-request-handling-gains-a-generic-dispatch-branch-ahe","heading":"Control-request handling gains a generic dispatch branch ahead of the hardcoded subtype switch","line":"Control-request handling gains a generic dispatch step that runs before the existing hardcoded request-type checks","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"parked-permission-cancelinterrupt-handling-factored-into-sh","heading":"Parked-permission cancel\/interrupt handling factored into shared helpers","line":"Interrupt handling for canceling queued messages was refactored into two shared helper functions","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"tengu-fizzy-grove-gate-swaps-the-interrupt-error-code","heading":"tengu_fizzy_grove gate swaps the interrupt error code","line":"A gate decides which of two error codes an interrupt-triggered abort reports.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"sdk-interrupt-can-cancel-queued-messages-and-reports-which-o","heading":"SDK interrupt() can cancel queued messages and reports which ones","line":"SDK interrupt can now cancel queued messages and tells you which ones it cancelled.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"},{"version":"2.1.238","anchor":"stop-task-control-request-stops-a-single-task","heading":"stop_task control request stops a single task","line":"SDK and remote drivers can stop a single task by id with a new control request.","released_at":"2026-08-20 18:01:54","reason":"found in this entry's text"},{"version":"2.1.227","anchor":"permissionrequest-hooks-can-interrupt-the-whole-turn","heading":"PermissionRequest hooks can interrupt the whole turn","line":"A PermissionRequest hook can now set `interrupt` to stop the whole turn, not just one tool call.","released_at":"2026-08-10 20:56:57","reason":"named in this entry, found in this entry's text"},{"version":"2.1.224","anchor":"managed-agents-sessions-can-carry-a-hard-dollar-spend-cap","heading":"Managed Agents sessions can carry a hard dollar spend cap","line":"The bundled Claude API docs now describe a hard dollar spend cap that pauses a session idle.","released_at":"2026-08-07 01:36:32","reason":"found in this entry's text"}],"entries_total":15,"docs":[{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/legal-summarization","title":"legal-summarization","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/claude-api-skill","title":"claude-api-skill","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/bash-tool","title":"bash-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/code-execution-tool","title":"code-execution-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/computer-use-tool","title":"computer-use-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/memory-tool","title":"memory-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/text-editor-tool","title":"text-editor-tool","documented":false},{"source":"api","path":"api\/beta\/messages\/batches","title":"Batches","documented":false},{"source":"api","path":"api\/beta\/messages\/batches\/cancel","title":"Cancel a Message Batch","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/interrupt","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}