Channels

Actions in the category "Channels".

Update channel name

Renames a channel on your server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to rename.
New name	Text	Yes	New name for the channel (1 - 100 characters). Length: 1 to 100 characters.
Audit log reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Updated channel	Server channel	The channel after the rename.

Create channel

Creates a new channel on a server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name of the new channel. Length: 1 to 100 characters.
Type	Channel type	Yes	Kind of channel to create. Allowed values: Text channel, Announcement channel, Voice channel, Stage channel, Category, Forum channel, Media channel. Default: Text channel.
Category	Category	No	Category to place the channel in. Shown when Type is Text channel, Announcement channel, Voice channel, Stage channel, Forum channel, Media channel.
Topic	Text	No	Channel topic (text-like channels only). Maximum length: 1024 characters. Shown when Type is Text channel, Announcement channel, Forum channel, Media channel.
NSFW	Yes/No	Yes	Mark the channel age-restricted. Default: No. Shown when Type is Text channel, Announcement channel, Voice channel, Forum channel, Media channel.
Slowmode	Duration	No	Slowmode duration (text-like channels only). Value: 0 to 21600000. Shown when Type is Text channel, Announcement channel, Forum channel, Media channel.
Bitrate	Whole number	No	Voice bitrate (voice channels only). Value: 8000 to 384000. Shown when Type is Voice channel, Stage channel.
User limit	Whole number	No	Maximum users (voice channel only). Value: 0 to 99. Shown when Type is.
Audit log reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Created channel	Server channel	The newly created channel.

Delete channel

Deletes a channel from your server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to delete.
Audit log reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Create text channel

Create a new text channel in a server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel (1-100 characters). Length: 1 to 100 characters.
Topic	Text	No	Optional topic shown above the channel. Maximum length: 1024 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position of the channel within its parent. Minimum: 0.
NSFW	Yes/No	No	Mark the channel as age-restricted. Default: No.
Slowmode (Seconds)	Whole number	No	Per-user slowmode delay in seconds (0-21600). Value: 0 to 21600.
Default Auto Archive	Auto archive duration	No	Default auto-archive duration for threads created here.
Default Thread Slowmode	Whole number	No	Default slowmode applied to new threads. Value: 0 to 21600.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites for the channel.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Text channel	The text channel that was created.

Create announcement channel

Create a new announcement channel that can be followed by other servers.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel. Length: 1 to 100 characters.
Topic	Text	No	Optional channel topic. Maximum length: 1024 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position within the parent. Minimum: 0.
NSFW	Yes/No	No	Mark the channel as age-restricted. Default: No.
Default Auto Archive	Auto archive duration	No	Default auto-archive duration for threads.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Announcement channel	The announcement channel that was created.

Create voice channel

Create a new voice channel in a server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel. Length: 1 to 100 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position within the parent. Minimum: 0.
Bitrate	Whole number	No	Audio bitrate in bits per second (8000-384000). Value: 8000 to 384000.
User Limit	Whole number	No	Maximum users allowed at once (0 for unlimited, max 99). Value: 0 to 99.
Voice Region	Text	No	Override the automatic voice region (leave empty for automatic).
Video Quality Mode	Video quality mode	No	Camera video quality mode.
NSFW	Yes/No	No	Mark the channel as age-restricted. Default: No.
Slowmode (Seconds)	Whole number	No	Slowmode for the chat tied to this voice channel. Value: 0 to 21600.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Voice channel	The voice channel that was created.

Create stage channel

Create a new stage channel for moderated audio events.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel. Length: 1 to 100 characters.
Topic	Text	No	Optional topic for the stage. Maximum length: 1024 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position within the parent. Minimum: 0.
Bitrate	Whole number	No	Audio bitrate in bits per second (8000-64000). Value: 8000 to 64000.
User Limit	Whole number	No	Maximum number of attendees (0 for unlimited). Value: 0 to 10000.
Voice Region	Text	No	Override the automatic voice region.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Stage channel	The stage channel that was created.

Create category channel

Create a new category that can group other channels.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new category. Length: 1 to 100 characters.
Position	Whole number	No	Sort position of the category. Minimum: 0.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Category	Category	The category that was created.

Create forum channel

Create a new forum channel for organized post-style discussions.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel. Length: 1 to 100 characters.
Guidelines	Text	No	Channel topic shown as posting guidelines. Maximum length: 4096 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position within the parent. Minimum: 0.
NSFW	Yes/No	No	Mark the channel as age-restricted. Default: No.
Post Slowmode	Whole number	No	Slowmode applied to creating new posts. Value: 0 to 21600.
Default Auto Archive	Auto archive duration	No	Default auto-archive duration for posts.
Default Post Slowmode	Whole number	No	Default per-message slowmode inside posts. Value: 0 to 21600.
Default Sort Order	Sort order	No	Default ordering of posts.
Default Layout	Forum layout	No	Default visual layout for the forum.
Default Reaction	Default reaction	No	Default reaction emoji shown on each post.
Available Tags	List of Forum tag	No	Tags that can be applied to posts in this forum.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Forum channel	The forum channel that was created.

Create media channel

Create a new media channel optimized for image and video posts.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Name for the new channel. Length: 1 to 100 characters.
Guidelines	Text	No	Channel topic shown as posting guidelines. Maximum length: 4096 characters.
Parent Category	Category	No	Category that will contain this channel.
Position	Whole number	No	Sort position within the parent. Minimum: 0.
NSFW	Yes/No	No	Mark the channel as age-restricted. Default: No.
Post Slowmode	Whole number	No	Slowmode applied to creating new posts. Value: 0 to 21600.
Default Auto Archive	Auto archive duration	No	Default auto-archive duration for posts.
Default Post Slowmode	Whole number	No	Default per-message slowmode inside posts. Value: 0 to 21600.
Default Sort Order	Sort order	No	Default ordering of posts.
Default Reaction	Default reaction	No	Default reaction emoji shown on each post.
Available Tags	List of Forum tag	No	Tags that can be applied to posts.
Permission Overwrites	List of Permission overwrite	No	Initial permission overwrites.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Media channel	The media channel that was created.

Update channel topic

Change a channel's topic text.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
New Topic	Text	No	New topic text. Leave empty to clear. Maximum length: 4096 characters.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update channel position

Move a channel to a new position in its parent or server.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to move.
New Position	Whole number	Yes	Zero-based target position. Minimum: 0.
Lock Permissions	Yes/No	No	Sync permissions with the new parent category if any. Default: No.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update channel parent

Move a channel into a different category, or remove it from any category.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to move.
New Parent Category	Category	No	Target category. Leave empty to remove from any category.
Lock Permissions	Yes/No	No	Sync permissions with the new parent category. Default: No.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update channel NSFW flag

Toggle whether a channel is marked as age-restricted (NSFW).

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
NSFW	Yes/No	Yes	True to mark as NSFW, false to unmark. Default: No.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update channel slowmode

Change the per-user slowmode of a text-like channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
Slowmode (Seconds)	Whole number	Yes	Per-user delay in seconds (0-21600). Value: 0 to 21600.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Fetch channel slowmode

Reads the per-user slowmode currently set on a channel.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to read the slowmode of.

Outputs

Name	Type	Details
Slowmode	Whole number	Per-user slowmode in seconds (0 when slowmode is off).

Update voice channel bitrate

Change the audio bitrate of a voice channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Voice channel	Yes	Voice channel to update.
Bitrate	Whole number	Yes	Audio bitrate in bits per second (8000-384000). Value: 8000 to 384000.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Voice channel	The updated voice channel.

Update voice channel user limit

Change the maximum number of users allowed in a voice channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Voice channel	Yes	Voice channel to update.
User Limit	Whole number	Yes	Maximum users (0 for unlimited, max 99). Value: 0 to 99.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Voice channel	The updated voice channel.

Update voice channel region

Override the voice region of a voice channel, or reset to automatic.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Voice channel	Yes	Voice channel to update.
Voice Region	Text	No	Region identifier (e.g. us-east). Leave empty for automatic.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Voice channel	The updated voice channel.

Update voice channel video quality

Change the camera video quality mode of a voice channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Voice channel	Yes	Voice channel to update.
Video Quality Mode	Video quality mode	Yes	Auto or forced 720p.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Voice channel	The updated voice channel.

Update default auto archive duration

Change the default auto-archive duration for threads created in this channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
Default Auto Archive	Auto archive duration	Yes	Default auto-archive duration.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update default thread slowmode

Change the default per-message slowmode for new threads in this channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
Default Thread Slowmode	Whole number	Yes	Default slowmode in seconds (0-21600). Value: 0 to 21600.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update default sort order

Change the default ordering of posts in a forum or media channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel to update.
Default Sort Order	Sort order	No	New default sort order. Leave empty to clear.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update forum layout

Change the default visual layout of a forum channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Forum channel	Yes	Forum channel to update.
Default Layout	Forum layout	Yes	List view, gallery view, or not set.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Forum channel	The updated forum channel.

Update default reaction

Change the default reaction emoji shown on posts in a forum or media channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel to update.
Default Reaction	Default reaction	No	Emoji to use as the default reaction. Leave empty to clear.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update available tags

Replace the set of tags that can be applied to posts in a forum or media channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel to update.
Available Tags	List of Forum tag	Yes	New full list of tags (max 20). Maximum items: 20.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Update channel flags

Set the bit-flag features enabled for a channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to update.
Flags	List of Channel flag	Yes	Channel flags to set.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The updated channel.

Convert announcement / text channel

Convert an announcement channel into a regular text channel, or back. Uses Discord's setType API.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to convert.
Convert To Text	Yes/No	Yes	True converts announcement -> text; false converts text -> announcement. Default: Yes.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The channel after the type change.

Clone channel

Create a copy of an existing channel including its settings and permission overwrites.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Source Channel	Server channel	Yes	Channel to clone.
Name	Text	No	Optional name for the cloned channel. Defaults to the source name. Length: 1 to 100 characters.
Parent Category	Category	No	Category for the cloned channel.
Position	Whole number	No	Position for the cloned channel. Minimum: 0.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The newly created clone.

Delete channel by ID

Delete a server channel using only its ID. Use when you don't have a channel reference.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel ID	Discord ID	Yes	ID of the channel to delete.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Deleted	Yes/No	True if the channel was deleted successfully.

Follow announcement channel

Subscribe a text channel to an announcement channel so its messages are crossposted.

Required permissions: Manage webhooks.

Inputs

Name	Type	Required	Details
Source Announcement Channel	Announcement channel	Yes	Announcement channel to follow.
Target Text Channel	Text channel	Yes	Text channel that will receive crossposted announcements.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Webhook ID	Discord ID	ID of the webhook created to deliver crossposted messages.

Sync permissions with category

Reset a channel's permission overwrites to match those of its parent category.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel whose permissions should be synced.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The channel after permissions were synced.

Create permission overwrite

Add a permission overwrite for a role or member on a channel.

Required permissions: Manage roles.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to modify.
Role	Role	No	Role this overwrite applies to. Use only one of these: Member.
Member	Server member	No	Member this overwrite applies to. Use only one of these: Role.
Allowed Permissions	List of Permission	No	Permissions explicitly granted.
Denied Permissions	List of Permission	No	Permissions explicitly denied.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The channel after the overwrite was added.

Build permission overwrite

Build a permission overwrite value for a role or member. Use the result in Add permission overwrite, then into a channel-creation action's permission overwrites.

Inputs

Name	Type	Required	Details
Role	Role	No	Role this overwrite applies to. Use only one of these: Member.
Member	Server member	No	Member this overwrite applies to. Use only one of these: Role.
Allowed Permissions	List of Permission	No	Permissions explicitly granted.
Denied Permissions	List of Permission	No	Permissions explicitly denied.

Outputs

Name	Type	Details
Overwrite	Permission overwrite	The constructed permission overwrite.

Add permission overwrite

Appends a permission overwrite to a list and returns the updated list. Use the result in a channel-creation action's permission overwrites.

Inputs

Name	Type	Required	Details
Overwrites	List of Permission overwrite	No	The overwrite list to extend (leave empty to start a new list).
Overwrite	Permission overwrite	Yes	The permission overwrite to append (from Build permission overwrite).

Outputs

Name	Type	Details
Overwrites	List of Permission overwrite	The updated overwrite list.

Update permission overwrite

Edit an existing permission overwrite for a role or member on a channel.

Required permissions: Manage roles.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to modify.
Role	Role	No	Role whose overwrite to update. Use only one of these: Member.
Member	Server member	No	Member whose overwrite to update. Use only one of these: Role.
Allowed Permissions	List of Permission	No	Permissions explicitly granted.
Denied Permissions	List of Permission	No	Permissions explicitly denied.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The channel after the overwrite was updated.

Delete permission overwrite

Remove the permission overwrite for a role or member on a channel.

Required permissions: Manage roles.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to modify.
Role	Role	No	Role whose overwrite to remove. Use only one of these: Member.
Member	Server member	No	Member whose overwrite to remove. Use only one of these: Role.
Audit Log Reason	Text	No	Reason recorded in the audit log. Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Server channel	The channel after the overwrite was removed.

Fetch permission overwrites

Get all permission overwrites configured on a channel.

Required permissions: View channel.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to inspect.

Outputs

Name	Type	Details
Overwrites	List of Permission overwrite	All permission overwrites on the channel.

Fetch channel by ID

Look up a channel within a server by its ID. Returns an empty value if the channel does not exist.

Required permissions: View channel.

Inputs

Name	Type	Required	Details
Channel ID	Discord ID	Yes	ID of the channel to fetch.
Force Refresh	Yes/No	No	Bypass the cache and request fresh data from Discord. Default: No.

Outputs

Name	Type	Details
Channel	Channel	The fetched channel, or empty if not found. May be empty.

Fetch channel invites

List all invites that point to a specific channel.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Channel to inspect.

Outputs

Name	Type	Details
Invites	List of Invite	Invites for the channel.

Fetch channel webhooks

List all webhooks in a single channel.

Required permissions: Manage webhooks.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	The channel to query.

Outputs

Name	Type	Details
Webhooks	List of Webhook	All webhooks in the channel.

Fetch server channels

List every channel in a server.

Required permissions: View channel.

Outputs

Name	Type	Details
Channels	List of Server channel	All channels in the server.

Show bot as typing in channel

Triggers the bot's typing indicator in a channel for roughly 10 seconds.

Required permissions: Send messages.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	The channel where the typing indicator should appear.

Treat channel as text channel

Narrow a generic channel to a server text channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Text channel	Text channel	Narrowed text channel, or empty if not a text channel. May be empty.

Treat channel as announcement channel

Narrow a generic channel to an announcement channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Announcement channel	Announcement channel	Narrowed announcement channel, or empty if not an announcement channel. May be empty.

Treat channel as voice channel

Narrow a generic channel to a voice channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Voice channel	Voice channel	Narrowed voice channel, or empty if not a voice channel. May be empty.

Treat channel as stage channel

Narrow a generic channel to a stage channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Stage channel	Stage channel	Narrowed stage channel, or empty if not a stage channel. May be empty.

Treat channel as category

Narrow a generic channel to a category. Returns nothing if the channel is not a category.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Category	Category	Narrowed category channel, or empty if not a category. May be empty.

Treat channel as forum channel

Narrow a generic channel to a forum channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Forum channel	Forum channel	Narrowed forum channel, or empty if not a forum channel. May be empty.

Treat channel as media channel

Narrow a generic channel to a media channel. Returns nothing if the channel is a different type.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Media channel	Media channel	Narrowed media channel, or empty if not a media channel. May be empty.

Treat channel as thread

Narrow a generic channel to a thread. Returns nothing if the channel is not a thread.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
Thread	Thread	Narrowed thread channel, or empty if not a thread. May be empty.

Treat channel as direct message

Narrow a generic channel to a DM channel. Returns nothing if the channel is a server channel.

Inputs

Name	Type	Required	Details
Channel	Channel	Yes	Channel to narrow.

Outputs

Name	Type	Details
DM channel	Direct message	Narrowed DM channel, or empty if not a DM. May be empty.

Create forum tag

Adds a new tag to the available tags of a forum or media channel. Requires MANAGE_CHANNELS.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel to add the tag to. Allowed values: FORUM_CHANNEL, MEDIA_CHANNEL.
Tag	Forum tag	Yes	Tag definition to append.
Audit Log Reason	Text	No	Reason recorded in the audit log (max 512 characters). Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Forum channel	The updated channel.

Update forum tag

Updates an existing tag of a forum or media channel. Requires MANAGE_CHANNELS.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel containing the tag. Allowed values: FORUM_CHANNEL, MEDIA_CHANNEL.
Tag ID	Discord ID	Yes	Discord ID of the tag to update.
Name	Text	No	New tag name (max 20 characters). Maximum length: 20 characters.
Emoji	Text	No	New emoji as unicode character or custom emoji ID/mention.
Moderated	Yes/No	No	Whether only members with MANAGE_THREADS may apply the tag.
Audit Log Reason	Text	No	Reason recorded in the audit log (max 512 characters). Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Forum channel	The updated channel.

Delete forum tag

Removes a tag from a forum or media channel. Requires MANAGE_CHANNELS.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	Forum or media channel containing the tag. Allowed values: FORUM_CHANNEL, MEDIA_CHANNEL.
Tag ID	Discord ID	Yes	Discord ID of the tag to remove.
Audit Log Reason	Text	No	Reason recorded in the audit log (max 512 characters). Maximum length: 512 characters.

Outputs

Name	Type	Details
Channel	Forum channel	The updated channel.

Bulk set channel positions

Repositions multiple channels in a single API call. Requires MANAGE_CHANNELS.

Required permissions: Manage channels.

Inputs

Name	Type	Required	Details
Updates	List of Channel position update	Yes	List of position updates to apply. Minimum items: 1.

Create channel position update

Builds a single channel reposition entry (a channel plus its new position, and optional lock-permissions / parent) for Bulk set channel positions. Collect entries with Add channel position or Add item to list.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	The channel to move.
Position	Whole number	Yes	The channel's new position (0 is first). Minimum: 0.
Lock Permissions	Yes/No	No	Sync the channel's permissions to its (new) parent category. Default: No.
Parent Category ID	Discord ID	No	The id of the category to move the channel under (leave empty to keep, set to nothing to move to the root).

Outputs

Name	Type	Details
Position Update	Channel position update	The constructed channel position update.

Add channel position

Appends a channel reposition entry (a channel plus its new position, and optional lock-permissions / parent) to a list and returns the updated list. Leave the list empty to start a new one; use the result in Bulk set channel positions.

Inputs

Name	Type	Required	Details
Updates	List of Channel position update	No	The position-update list to extend (leave empty to start a new list). Maximum items: 500.
Channel	Server channel	Yes	The channel to move.
Position	Whole number	Yes	The channel's new position (0 is first). Minimum: 0.
Lock Permissions	Yes/No	No	Sync the channel's permissions to its (new) parent category. Default: No.
Parent Category ID	Discord ID	No	The id of the category to move the channel under (leave empty to keep, set to nothing to move to the root).

Outputs

Name	Type	Details
Updates	List of Channel position update	The updated position-update list.

Fetch channel by name

Finds a channel on the server by its name. Optionally filter by channel type.

Inputs

Name	Type	Required	Details
Name	Text	Yes	Channel name to search for. Length: 1 to 100 characters.
Type	Channel type	No	Restrict to this channel type.
Case sensitive	Yes/No	Yes	Match upper/lower case exactly. Default: No.

Outputs

Name	Type	Details
Channel	Server channel	The first matching channel, or empty. May be empty.