n8n_delete_execution
Remove a specific workflow execution by ID to manage automation history. This action cannot be undone, so use it to delete completed or failed executions.
Instructions
Delete a specific execution by ID.
⚠️ WARNING: This action cannot be undone!
Args:
id (string): Execution ID to delete
Returns: Confirmation of deletion.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The unique identifier of the resource |
Implementation Reference
- src/tools/executions.ts:146-175 (handler)The registration and handler implementation for the 'n8n_delete_execution' tool. It uses the `IdParamSchema` for input validation and calls the `del` service to perform the API request.
server.registerTool( 'n8n_delete_execution', { title: 'Delete n8n Execution', description: `Delete a specific execution by ID. ⚠️ WARNING: This action cannot be undone! Args: - id (string): Execution ID to delete Returns: Confirmation of deletion.`, inputSchema: IdParamSchema, annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false } }, async (params: z.infer<typeof IdParamSchema>) => { await del(`/executions/${params.id}`); return { content: [{ type: 'text', text: `✅ Execution ${params.id} deleted successfully.` }], structuredContent: { deleted: true, id: params.id } }; } );