Delete webhook
discord_
Destructive
- Toolset
- Webhooks
webhooks - Discord permission
- Manage Webhooks
- Context cost
- 172 tokens, estimated688 bytes of definition, divided by 4
Permanently delete a webhook by its ID, invalidating its token. IRREVERSIBLE: any integrations using the old token will stop working. Requires the Manage Webhooks permission. To remove one message the webhook sent, use discord_ instead; discord_ finds the ID.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | yes | May perform destructive updates, so clients can ask before running it. |
IdempotentidempotentHint | no | Repeating the call can have an 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 to delete. |
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
-
Delete webhook message, Destructive
discord_delete_ webhook_ message -
List webhooks, Read-only
discord_list_ webhooks
Also in Webhooks
Raw definition (688 bytes)
{
"name": "discord_delete_webhook",
"description": "Permanently delete a webhook by its ID, invalidating its token. IRREVERSIBLE: any integrations using the old token will stop working. Requires the Manage Webhooks permission. To remove one message the webhook sent, use discord_delete_webhook_message instead; discord_list_webhooks finds the ID.",
"inputSchema": {
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the webhook to delete."
}
},
"required": [
"webhook_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Delete webhook",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
}