n8n_delete_execution
Remove execution records from n8n workflow history to manage data and maintain system performance.
Instructions
Delete an execution record.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The execution ID to delete |
Implementation Reference
- src/tools/execution-tools.ts:189-211 (handler)The handler function that validates the execution ID, calls the N8nApiClient to delete the execution, and returns a success response.
n8n_delete_execution: async ( client: N8nApiClient, args: Record<string, unknown> ): Promise<ToolResult> => { const id = args.id as string; if (!id) { throw new Error('Execution ID is required'); } await client.deleteExecution(id); return { content: [ { type: 'text' as const, text: JSON.stringify({ success: true, message: `Execution ${id} deleted successfully`, }, null, 2), }, ], }; }, - src/tools/execution-tools.ts:58-71 (schema)The tool definition including name, description, and input schema requiring 'id' parameter.
{ name: 'n8n_delete_execution', description: 'Delete an execution record.', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'The execution ID to delete', }, }, required: ['id'], }, }, - src/server.ts:127-131 (registration)Runtime registration and dispatch: checks if the tool name exists in executionToolHandlers and invokes the handler with API client and arguments.
// Execution tools if (name in executionToolHandlers) { const handler = executionToolHandlers[name as keyof typeof executionToolHandlers]; return handler(client, args); } - src/tools/index.ts:12-16 (registration)Aggregates all tool definitions (including n8n_delete_execution schema) into allTools array used for listing available tools.
export const allTools: ToolDefinition[] = [ ...documentationTools, // Documentation first for discoverability ...workflowTools, ...executionTools, ];