Edit webhook message
discord_
Write
- Toolset
- Webhooks
webhooks - Context cost
- 750 tokens, estimated3,000 bytes of definition, divided by 4
Edit a message previously sent through a webhook, using the webhook's ID and token. Replaces the provided fields. No bot permission is needed: the token authorizes the edit. For a message the bot sent itself, use discord_ or discord_. Returns a confirmation.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | yes | Repeating the call with the same arguments has no additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| webhook_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the webhook that sent the message. |
| webhook_ | string | none | Secret token of the webhook. |
| message_ | string | pattern ^\d{17,20}$ | ID of the webhook message to edit. |
| contentoptional | string | none | New plain-text content for the message (max 2000 characters). |
| embedsoptional | array of objects | at most 10 items | Up to 10 embed objects to attach to the webhook message. |
| title (nested, level 1) | string | none | Embed title shown in bold at the top. |
| url (nested, level 1) | string | format uripattern ^https?:// | URL that makes the title clickable. |
| description (nested, level 1) | string | none | Main body text of the embed (supports Markdown). |
| color (nested, level 1) | string | pattern ^#[0-9A-Fa-f]{6}$ | Side-bar color as a hex string, e.g. '#5865F2'. |
| fields (nested, level 1) | array of objects | none | Up to 25 name/value field blocks. Set inline:true on a field to render it side-by-side with adjacent inline fields (up to 3 per row). |
| name (nested, level 2)required | string | none | Field heading. |
| value (nested, level 2)required | string | none | Field body text. |
| inline (nested, level 2) | boolean | none | If true, render this field side-by-side with adjacent inline fields. |
| author (nested, level 1) | object | none | Author block shown at the top of the embed. |
| name (nested, level 2)required | string | none | Author display name. |
| icon_ | string | format uripattern ^https?:// | Small icon shown next to the author name. |
| url (nested, level 2) | string | format uripattern ^https?:// | URL the author name links to. |
| thumbnail_ | string | format uripattern ^https?:// | Small image shown in the top-right corner. |
| footer (nested, level 1) | string | none | Footer text shown at the bottom of the embed. |
| image_ | string | format uripattern ^https?:// | Large image shown below the embed body. |
| timestamp (nested, level 1) | boolean | none | If true, stamp the embed with the current time. |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Named in its description
Also in Webhooks
-
Create webhook, Write
discord_create_ webhook -
Send webhook message, Write
discord_send_ webhook_ message -
Edit webhook, Write
discord_edit_ webhook -
Delete webhook, Destructive
discord_delete_ webhook -
List webhooks, Read-only
discord_list_ webhooks -
Delete webhook message, Destructive
discord_delete_ webhook_ message -
Fetch webhook message, Read-only
discord_fetch_ webhook_ message
Raw definition (3,000 bytes)
{
"name": "discord_edit_webhook_message",
"description": "Edit a message previously sent through a webhook, using the webhook's ID and token. Replaces the provided fields. No bot permission is needed: the token authorizes the edit. For a message the bot sent itself, use discord_edit_message or discord_edit_embed. Returns a confirmation.",
"inputSchema": {
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the webhook that sent the message."
},
"webhook_token": {
"type": "string",
"description": "Secret token of the webhook."
},
"message_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID of the webhook message to edit."
},
"content": {
"description": "New plain-text content for the message (max 2000 characters).",
"type": "string"
},
"embeds": {
"description": "Up to 10 embed objects to attach to the webhook message.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"description": "Embed title shown in bold at the top.",
"type": "string"
},
"url": {
"description": "URL that makes the title clickable.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"description": {
"description": "Main body text of the embed (supports Markdown).",
"type": "string"
},
"color": {
"description": "Side-bar color as a hex string, e.g. '#5865F2'.",
"type": "string",
"pattern": "^#[0-9A-Fa-f]{6}$"
},
"fields": {
"description": "Up to 25 name/value field blocks. Set inline:true on a field to render it side-by-side with adjacent inline fields (up to 3 per row).",
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Field heading."
},
"value": {
"type": "string",
"description": "Field body text."
},
"inline": {
"description": "If true, render this field side-by-side with adjacent inline fields.",
"type": "boolean"
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"author": {
"description": "Author block shown at the top of the embed.",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Author display name."
},
"icon_url": {
"description": "Small icon shown next to the author name.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"url": {
"description": "URL the author name links to.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"thumbnail_url": {
"description": "Small image shown in the top-right corner.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"footer": {
"description": "Footer text shown at the bottom of the embed.",
"type": "string"
},
"image_url": {
"description": "Large image shown below the embed body.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"timestamp": {
"description": "If true, stamp the embed with the current time.",
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"required": [
"webhook_id",
"webhook_token",
"message_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Edit webhook message",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}