clear_messages

Delete messages from a channel. This is a DESTRUCTIVE action that follows the requester action tier and approval mode before execution. Use only when explicitly asked to delete messages.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Delete messages 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 to delete messages from (from resolve_channel_targets or list_guild_structure)."
    },
    "count": {
      "type": "number",
      "description": "Number of messages to delete (1-100)."
    },
    "author_id": {
      "type": "string",
      "description": "Optional: only delete messages from this author (Discord snowflake ID)."
    }
  },
  "required": [
    "channel_id",
    "count"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• channel must be accessible

Expected postconditions

• deletes messages from the target channel