Channel Tools

Guild channel lifecycle and permission overwrite management.

Most channel tools accept either direct channel IDs or channel names. Name resolution is easiest and safest when a guild scope is provided.

create_guild_channel #

• Purpose: create a guild channel.
• Key arguments: guild_id or guild_name, name, type.
• Optional fields: topic, parent_id, nsfw, rate_limit_per_user, permission_overwrites.

edit_channel #

• Purpose: update channel settings.
• Key arguments: channel_id or channel_name (optional guild scope).
• Optional fields: name/topic/slowmode/parent/nsfw and more.
• Notes:
• works for regular guild channels and thread-like channel objects supported by Discord on the same route.

delete_channel #

• Purpose: delete or close a channel.
• Key arguments: channel_id or channel_name (optional guild scope).
• Notes:
• works for regular channels
• also works for threads, where Discord treats the operation as closing or deleting that thread through the same route

edit_channel_permissions #

• Purpose: create or update a permission overwrite.
• Key arguments: channel scope, overwrite_type, overwrite_id or overwrite_name, allow, deny.
• Notes:
• overwrite_type selects whether the target is a role or a member.
• Name-based overwrite resolution works best when the guild is explicit.

delete_channel_permissions #

• Purpose: delete a permission overwrite.
• Key arguments: channel scope, overwrite_type, overwrite_id or overwrite_name.