delete_execution
Remove a specific workflow execution from n8n by providing its unique ID to manage system resources and maintain execution history.
Instructions
Delete an n8n execution
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
Implementation Reference
- src/index.ts:493-496 (handler)MCP tool handler that calls n8nClient.deleteExecution and formats the success response.private async handleDeleteExecution(args: { id: string }) { await this.n8nClient.deleteExecution(args.id); return { content: [{ type: 'text', text: JSON.stringify(jsonSuccess({ id: args.id }), null, 2) }] }; }
- src/index.ts:197-197 (schema)Input schema definition for the delete_execution tool, requiring a string 'id'.{ name: 'delete_execution', description: 'Delete an n8n execution', inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] } },
- src/index.ts:292-293 (registration)Tool dispatch/registration in the CallToolRequestHandler switch statement.case 'delete_execution': return await this.handleDeleteExecution(request.params.arguments as { id: string });
- src/n8n-client.ts:748-751 (helper)N8nClient helper method that performs the actual DELETE API call to /executions/{id}.async deleteExecution(id: string): Promise<N8nExecutionDeleteResponse> { await this.api.delete(`/executions/${id}`); return { success: true }; }