messages_delete
messages_delete
Section titled “messages_delete”Category: messages
Delete a single message from a Discord channel. DESTRUCTIVE — IRREVERSIBLE.
When to use
Section titled “When to use”remove spam/policy violations; clean up stale bot messages.
When NOT to use
Section titled “When NOT to use”bulk delete (use messages_bulk_delete Plan 7+); audit trail removal.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Channel containing the message |
message_id | string | yes | Message to delete (IRREVERSIBLE) |
Returns
Section titled “Returns”\{deleted, message_id, channel_id\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
deleted | boolean | yes | |
message_id | string | yes | Discord message ID |
channel_id | string | yes | Discord channel ID (snowflake) |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | yes |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | yes (__confirm:true required) |