n8n_delete_tag
DestructiveIdempotent
Remove a tag from the n8n system and automatically detach it from all associated workflows while keeping the workflows intact.
Instructions
Remove tag from system. Automatically removes this tag from all workflows using it. Tag removal does not affect workflows themselves, only the tag association.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Tag ID to permanently delete |
Implementation Reference
- src/n8n-client.ts:179-181 (handler)Handler function that executes the deleteTag logic by making an HTTP DELETE request to the n8n API endpoint /tags/{id}
async deleteTag(id: string) { return this.request(`${this.apiBase}/tags/${id}`, { method: 'DELETE' }); } - src/tools.ts:417-433 (schema)Tool schema definition with name, description, input parameters (id: string, required), and annotations indicating it's a destructive, idempotent operation
name: 'n8n_delete_tag', description: 'Remove tag from system. Automatically removes this tag from all workflows using it. Tag removal does not affect workflows themselves, only the tag association.', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Tag ID to permanently delete' }, }, required: ['id'], }, annotations: { title: 'Delete Tag', readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true, }, }, - src/server.ts:75-76 (registration)Switch case that routes 'n8n_delete_tag' tool calls to the client.deleteTag handler method with the id argument
case 'n8n_delete_tag': return client.deleteTag(args.id);