reactions_delete_user
reactions_delete_user
Section titled “reactions_delete_user”Category: reactions
Remove a specific user’s reaction from a message (mod action).
When to use
Section titled “When to use”- Strip an offending user reaction without clearing the whole emoji.
When NOT to use
Section titled “When NOT to use”- Bot’s own reaction → use
reactions_delete_own. - Clearing every user for an emoji → use
reactions_delete_allwithemoji.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Channel containing the message |
message_id | string | yes | Message to update |
emoji | string | yes | Unicode emoji or name:id for custom emoji |
user_id | string | yes | User whose reaction to remove |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{deleted, channel_id, message_id, emoji, user_id\}. Requires Manage Messages.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
deleted | boolean | yes | |
channel_id | string | yes | Discord channel ID (snowflake) |
message_id | string | yes | Discord message ID |
emoji | string | yes | |
user_id | string | yes | Discord user ID |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |