Copy channel permissions
discord_
Destructive
- Toolset
- Permissions
permissions - Discord permissions
- Manage Channels and Manage Roles
- Context cost
- 301 tokens, estimated1,205 bytes of definition, divided by 4
Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Channels and Manage Roles permissions, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation. To create a new channel with the same overwrites, use discord_; to remove them all, use discord_.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | yes | May perform destructive updates, so clients can ask before running it. |
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 |
|---|---|---|---|
| source_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel to copy overwrites from. |
| target_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel whose overwrites will be replaced. |
| reasonoptional | string | none | Optional reason recorded in the server audit log. |
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
-
Clone channel, Write
discord_clone_ channel -
Reset channel permissions, Destructive
discord_reset_ channel_ permissions
Also in Permissions
Raw definition (1,205 bytes)
{
"name": "discord_copy_permissions",
"description": "Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Channels and Manage Roles permissions, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation. To create a new channel with the same overwrites, use discord_clone_channel; to remove them all, use discord_reset_channel_permissions.",
"inputSchema": {
"type": "object",
"properties": {
"source_channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the channel to copy overwrites from."
},
"target_channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the channel whose overwrites will be replaced."
},
"reason": {
"description": "Optional reason recorded in the server audit log.",
"type": "string"
}
},
"required": [
"source_channel_id",
"target_channel_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Copy channel permissions",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}
}