notion_delete_block
Remove unwanted content blocks from Notion pages to maintain organized workspaces and declutter documents.
Instructions
Delete a block in Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_id | Yes | The ID of the block to delete.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| format | No | Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it. | markdown |
Implementation Reference
- src/client/index.ts:80-87 (handler)Core implementation of the notion_delete_block tool: sends DELETE request to Notion API /blocks/{block_id} endpoint.async deleteBlock(block_id: string): Promise<BlockResponse> { const response = await fetch(`${this.baseUrl}/blocks/${block_id}`, { method: "DELETE", headers: this.headers, }); return response.json(); }
- src/server/index.ts:90-98 (handler)Server-side dispatch handler for notion_delete_block: validates input arguments and delegates to NotionClientWrapper.deleteBlock.case "notion_delete_block": { const args = request.params .arguments as unknown as args.DeleteBlockArgs; if (!args.block_id) { throw new Error("Missing required argument: block_id"); } response = await notionClient.deleteBlock(args.block_id); break; }
- src/types/schemas.ts:83-97 (schema)Tool schema definition including name, description, and input schema for notion_delete_block.export const deleteBlockTool: Tool = { name: "notion_delete_block", description: "Delete a block in Notion", inputSchema: { type: "object", properties: { block_id: { type: "string", description: "The ID of the block to delete." + commonIdDescription, }, format: formatParameter, }, required: ["block_id"], }, };
- src/server/index.ts:308-308 (registration)Registration of the notion_delete_block tool in the list of available tools returned by ListToolsRequest.schemas.updateBlockTool,
- src/types/args.ts:27-30 (schema)TypeScript interface for the input arguments used in the handler.export interface DeleteBlockArgs { block_id: string; format?: "json" | "markdown"; }