reactions_delete_all
reactions_delete_all
Section titled “reactions_delete_all”Category: reactions
Clear reactions on a message. Without emoji: clears EVERY reaction. With emoji: clears just that emoji across all users. DESTRUCTIVE — IRREVERSIBLE.
When to use
Section titled “When to use”- Reset a poll; remove a corrupted reaction set.
- Mod cleanup after spam reactions.
When NOT to use
Section titled “When NOT to use”- Removing only one user’s reaction → use
reactions_delete_user.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Channel containing the message |
message_id | string | yes | Message to clear reactions on |
emoji | string | no | If provided, clear only this emoji; else clear all reactions |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{deleted, channel_id, message_id, scope\} where scope is "all" or "emoji".
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 |
scope | string | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | yes |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | yes (__confirm:true required) |