Delete channel
discord_
DestructiveDry run by default
- Toolset
- Channels
channels - Discord permission
- Manage Channels
- Context cost
- 280 tokens, estimated1,119 bytes of definition, divided by 4
Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Deleting a category keeps its channels, which leave the category. A DM channel ID only closes the DM, which is reversible. Requires the Manage Channels permission, or Manage Threads for a thread. An optional reason is recorded in the audit log.
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 |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel to delete. |
| reasonoptional | string | none | Optional reason recorded in the server audit log. |
| dry_ | boolean | default true | If true (default), only reports which channel would be deleted without deleting it. Set false to actually 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
Also in Channels
-
Create channel, Write
discord_create_ channel -
Edit channel, Write
discord_edit_ channel -
Move channel, Write
discord_move_ channel -
Clone channel, Write
discord_clone_ channel -
Set channel position, Write
discord_set_ channel_ position -
Follow announcement channel, Write
discord_follow_ announcement_ channel -
Sync channel permissions, Write
discord_lock_ channel_ permissions
Raw definition (1,119 bytes)
{
"name": "discord_delete_channel",
"description": "Permanently delete a channel and all of its messages. IRREVERSIBLE. SAFE BY DEFAULT: dry_run is true unless explicitly set to false, so call it first to preview, then re-call with dry_run:false to actually delete. Deleting a category keeps its channels, which leave the category. A DM channel ID only closes the DM, which is reversible. Requires the Manage Channels permission, or Manage Threads for a thread. An optional reason is recorded in the audit log.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the channel to delete."
},
"reason": {
"description": "Optional reason recorded in the server audit log.",
"type": "string"
},
"dry_run": {
"default": true,
"description": "If true (default), only reports which channel would be deleted without deleting it. Set false to actually delete.",
"type": "boolean"
}
},
"required": [
"channel_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Delete channel",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
}