set_channel_permissions(Args{
channel_id: trigger.channel_id,
target_type: "User",
target_id: "...",
operation_mode: "Replace Existing Overrides",
})
Set Channel Permissions
BlockChannels
Set allowed and denied permission overrides for a user or role in a channel. Supports setting both allow and deny in one block, and can either replace existing overrides or update them.
Inputs
Channel IDRequired
ID of the channel to set permissions for.
Target TypeRequired
Whether the permission overwrite applies to a user or a role.
OptionsUserRole
User or Role IDRequired
ID of the user or role to set permissions for. You can type @everyone as a shortcut to the @everyone role ID.
Server ID
Required when using @everyone as the target.
Allow Permissions
Permissions to explicitly allow.
OptionsAdd ReactionsAdministratorAttach FilesBan MembersBypass SlowmodeChange NicknameConnectCreate EventsCreate ExpressionsCreate Instant InviteCreate Private ThreadsCreate Public ThreadsDeafen MembersEmbed LinksKick MembersManage ChannelsManage EventsManage ExpressionsManage MessagesManage NicknamesManage RolesManage ServerManage ThreadsManage WebhooksMention EveryoneMove MembersMute MembersPin MessagesPriority SpeakerRead Message HistoryRequest to SpeakSend MessagesSend Messages in ThreadsSend PollsSend TTS MessagesSend Voice MessagesSet Voice Channel StatusSpeakStreamTimeout MembersUse Application CommandsUse Embedded ActivitiesUse External AppsUse External EmojisUse External SoundsUse External StickersUse SoundboardUse VADView Audit LogView ChannelView Creator Monetization AnalyticsView Guild Insights
Deny Permissions
Permissions to explicitly deny.
OptionsAdd ReactionsAdministratorAttach FilesBan MembersBypass SlowmodeChange NicknameConnectCreate EventsCreate ExpressionsCreate Instant InviteCreate Private ThreadsCreate Public ThreadsDeafen MembersEmbed LinksKick MembersManage ChannelsManage EventsManage ExpressionsManage MessagesManage NicknamesManage RolesManage ServerManage ThreadsManage WebhooksMention EveryoneMove MembersMute MembersPin MessagesPriority SpeakerRead Message HistoryRequest to SpeakSend MessagesSend Messages in ThreadsSend PollsSend TTS MessagesSend Voice MessagesSet Voice Channel StatusSpeakStreamTimeout MembersUse Application CommandsUse Embedded ActivitiesUse External AppsUse External EmojisUse External SoundsUse External StickersUse SoundboardUse VADView Audit LogView ChannelView Creator Monetization AnalyticsView Guild Insights
Operation ModeRequired
"Replace Existing Overrides" clears the target's current permission overrides before applying the new ones. "Update Existing Overrides" merges the new permissions into the existing ones, leaving unrelated permissions unchanged.
OptionsReplace Existing OverridesUpdate Existing Overrides
Build a bot using blocks like Set Channel Permissions
Use this block in our visual flow editor. Bots are hosted 24/7 for free on inventor.bot.
Advanced Documentation
This documentation can be useful when using code mode. View as Markdown
ID:
set_channel_permissionsInputs
| Field | InventScript name | Value |
|---|---|---|
| Channel ID | channel_id | |
| Target Type | target_type | "User", "Role" |
| User or Role ID | target_id | |
| Server ID | server_id | |
| Allow Permissions | allow_permissions | "Add Reactions", "Administrator", "Attach Files", "Ban Members", "Bypass Slowmode", "Change Nickname", "Connect", "Create Events", "Create Expressions", "Create Instant Invite", "Create Private Threads", "Create Public Threads", "Deafen Members", "Embed Links", "Kick Members", "Manage Channels", "Manage Events", "Manage Expressions", "Manage Messages", "Manage Nicknames", "Manage Roles", "Manage Server", "Manage Threads", "Manage Webhooks", "Mention Everyone", "Move Members", "Mute Members", "Pin Messages", "Priority Speaker", "Read Message History", "Request to Speak", "Send Messages", "Send Messages in Threads", "Send Polls", "Send TTS Messages", "Send Voice Messages", "Set Voice Channel Status", "Speak", "Stream", "Timeout Members", "Use Application Commands", "Use Embedded Activities", "Use External Apps", "Use External Emojis", "Use External Sounds", "Use External Stickers", "Use Soundboard", "Use VAD", "View Audit Log", "View Channel", "View Creator Monetization Analytics", "View Guild Insights" |
| Deny Permissions | deny_permissions | "Add Reactions", "Administrator", "Attach Files", "Ban Members", "Bypass Slowmode", "Change Nickname", "Connect", "Create Events", "Create Expressions", "Create Instant Invite", "Create Private Threads", "Create Public Threads", "Deafen Members", "Embed Links", "Kick Members", "Manage Channels", "Manage Events", "Manage Expressions", "Manage Messages", "Manage Nicknames", "Manage Roles", "Manage Server", "Manage Threads", "Manage Webhooks", "Mention Everyone", "Move Members", "Mute Members", "Pin Messages", "Priority Speaker", "Read Message History", "Request to Speak", "Send Messages", "Send Messages in Threads", "Send Polls", "Send TTS Messages", "Send Voice Messages", "Set Voice Channel Status", "Speak", "Stream", "Timeout Members", "Use Application Commands", "Use Embedded Activities", "Use External Apps", "Use External Emojis", "Use External Sounds", "Use External Stickers", "Use Soundboard", "Use VAD", "View Audit Log", "View Channel", "View Creator Monetization Analytics", "View Guild Insights" |
| Operation Mode | operation_mode | "Replace Existing Overrides", "Update Existing Overrides" |
Example InventScript
More channels blocks
Get ChannelRetrieve a Discord channel's information by its ID.Create ChannelCreate a text/voice/stage/etc channel or channel category in a server.Modify ChannelModify a channel's information by its ID.Move ChannelMove a channel to a new category.Move Member to Voice ChannelMove a member from one voice channel to another.Get ChannelsRetrieve a Discord server's channels by its ID.Delete ChannelDelete a Discord channel by its ID.Trigger Typing IndicatorTrigger a typing indicator in a channel.Delete Channel PermissionDelete a channel permission overwrite for a user or role.