delete_messages

Delete one or more specific messages from a channel by their IDs. This is a DESTRUCTIVE action that follows the requester action tier and approval mode. Use only when the user explicitly asks to delete specific message(s). IMPORTANT: You must obtain the real message IDs first — use search_messages or retrieve_messages to locate the target messages, then pass their IDs here. Never guess or fabricate message IDs. For bulk deletion of the most recent history without specific targets, use clear_messages instead.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Delete specific messages by ID from a Discord channel. Destructive — follows the requester action tier and approval mode with confirmation modal.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "The channel ID where the messages live (from resolve_channel_targets or list_guild_structure)."
    },
    "message_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The Discord snowflake IDs of the specific messages to delete (1-50). Obtain these by searching first (e.g. search_messages or retrieve_messages in the target channel) — never guess or fabricate IDs."
    }
  },
  "required": [
    "channel_id",
    "message_ids"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• channel must be accessible
• message IDs must be known

Expected postconditions

• deletes the specified messages from the target channel