Edit channel
discord_
Write
- Toolset
- Channels
channels - Discord permission
- Manage Channels
- Context cost
- 292 tokens, estimated1,166 bytes of definition, divided by 4
Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change. This tool sends topic and slowmode for plain text channels only; on every other type, announcement channels included, it ignores them without an error. Requires the Manage Channels permission. 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 |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel to edit. |
| nameoptional | string | none | New channel name (max 100 characters). |
| topicoptional | string | none | New topic/description (text channels only, not announcement). |
| slowmodeoptional | integer | 0 to 21600 | Per-user message cooldown in seconds, 0–21600. 0 disables slowmode (text channels only, not announcement). |
| nsfwoptional | boolean | none | Mark (true) or unmark (false) the channel as age-restricted (NSFW). |
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 -
Delete channel, Destructive
discord_delete_ 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,166 bytes)
{
"name": "discord_edit_channel",
"description": "Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change. This tool sends topic and slowmode for plain text channels only; on every other type, announcement channels included, it ignores them without an error. Requires the Manage Channels permission. Returns a confirmation.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the channel to edit."
},
"name": {
"description": "New channel name (max 100 characters).",
"type": "string"
},
"topic": {
"description": "New topic/description (text channels only, not announcement).",
"type": "string"
},
"slowmode": {
"description": "Per-user message cooldown in seconds, 0–21600. 0 disables slowmode (text channels only, not announcement).",
"type": "integer",
"minimum": 0,
"maximum": 21600
},
"nsfw": {
"description": "Mark (true) or unmark (false) the channel as age-restricted (NSFW).",
"type": "boolean"
}
},
"required": [
"channel_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Edit channel",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}