n8n_delete_user
DestructiveIdempotent
Remove a user from your n8n instance to revoke access immediately while preserving their workflows. Requires instance owner permissions.
Instructions
Remove user from n8n instance. Only available to instance owner. Cannot delete the owner account. Deleted users lose access immediately. Workflows created by this user remain intact.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | User ID to permanently delete (not email) |
Implementation Reference
- src/n8n-client.ts:215-217 (handler)The deleteUser method that implements the tool logic - makes a DELETE request to the n8n API endpoint /users/{id}
async deleteUser(id: string) { return this.request(`${this.apiBase}/users/${id}`, { method: 'DELETE' }); } - src/tools.ts:470-486 (schema)Tool definition with input schema requiring an 'id' parameter (string) and annotations indicating it's a destructive operation
name: 'n8n_delete_user', description: 'Remove user from n8n instance. Only available to instance owner. Cannot delete the owner account. Deleted users lose access immediately. Workflows created by this user remain intact.', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'User ID to permanently delete (not email)' }, }, required: ['id'], }, annotations: { title: 'Delete User', readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true, }, }, - src/server.ts:83-84 (registration)Routes the 'n8n_delete_user' tool call to the client.deleteUser method with the id argument
case 'n8n_delete_user': return client.deleteUser(args.id);