edit_message

Edit an existing message that was sent by the bot. This is a WRITE action that follows the requester action tier and approval mode. Use only when explicitly asked to edit a message. The bot can only edit its own messages. IMPORTANT: You must obtain the real message ID first — use search_messages (e.g. with author_type ‘bot’ in the target channel, or content keywords) to find the message, then pass its ID here. Never guess or fabricate a message ID.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Edit an existing message sent by the bot. Write — follows the requester action tier and approval mode.

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 message is (from resolve_channel_targets or list_guild_structure)."
    },
    "message_id": {
      "type": "string",
      "description": "The Discord snowflake ID of the message to edit. Obtain this by searching first (e.g. search_messages with author_type 'bot' in the target channel)."
    },
    "content": {
      "type": "string",
      "description": "The new content for the message."
    }
  },
  "required": [
    "channel_id",
    "message_id",
    "content"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• message must be authored by the bot

Expected postconditions

• edits the target message content