Delete alias
delete_aliasDestructiveIdempotent
Permanently delete an alias. This cannot be undone — future mail to the address is rejected. Accepts either the alias ID or the full email address. This tool is flagged destructive (annotations.destructiveHint): MCP clients request user approval before executing it, and fail the call with 'No approval received' — without contacting this server — if approval is denied or unavailable (e.g. headless sessions). Nothing is deleted in that case; approve the client's permission prompt, or allowlist this tool in the client's permissions for unattended use.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Alias ID (from list_aliases) or the full alias email address, e.g. 'jane.doe@anon.li' |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| Yes | |||
| deleted | Yes |