emojis_delete
emojis_delete
Section titled “emojis_delete”Category: emojis
Delete a custom guild emoji. DESTRUCTIVE — IRREVERSIBLE.
When to use
Section titled “When to use”- Retire a stale or off-brand emoji.
When NOT to use
Section titled “When NOT to use”- Application emoji → use
app_emojis_delete.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild owning the emoji |
emoji_id | string | yes | Emoji to delete |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
confirm | boolean | no | Must be true to actually perform the destructive action |
Returns
Section titled “Returns”\{deleted, guild_id, emoji_id\}. Pass __confirm:true AND set MCP_DRY_RUN=false to actually delete.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
deleted | boolean | yes | |
guild_id | string | yes | Discord guild (server) ID |
emoji_id | string | yes | Discord custom emoji ID |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | yes |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | yes (__confirm:true required) |