Skip to main content
Version: Next

RESTPatchAPIChannelJSONBody

Index

Properties

optionalapplied_tags

applied_tags?: string[]

The ids of the set of tags that have been applied to a thread-only channel; limited to 5

Channel types: forum, media

optionalarchived

archived?: boolean

Whether the thread should be archived

Channel types: newsThread, publicThread, privateThread

optionalauto_archive_duration

auto_archive_duration?: ThreadAutoArchiveDuration

The amount of time in minutes to wait before automatically archiving the thread

Channel types: newsThread, publicThread, privateThread

optionalavailable_tags

available_tags?: (Partial<APIGuildForumTag> & Pick<APIGuildForumTag, name>)[]

The set of tags that can be used in a thread-only channel; limited to 20

Channel types: forum, media

optionalbitrate

bitrate?: null | number

The bitrate (in bits) of the voice channel; 8000 to 96000 (128000 for VIP servers)

Channel types: voice

optionaldefault_auto_archive_duration

default_auto_archive_duration?: ThreadAutoArchiveDuration

Default duration for newly created threads, in minutes, to automatically archive the thread after recent activity

Channel types: text, news, forum, media

optionaldefault_forum_layout

default_forum_layout?: ForumLayoutType

The default layout type used to display posts in a forum channel

Channel types: forum

optionaldefault_reaction_emoji

default_reaction_emoji?: APIGuildForumDefaultReactionEmoji

The emoji to show in the add reaction button on a thread in a thread-only channel

Channel types: forum, media

optionaldefault_sort_order

default_sort_order?: null | SortOrderType

The default sort order type used to order posts in a thread-only channel

Channel types: forum, media

optionaldefault_thread_rate_limit_per_user

default_thread_rate_limit_per_user?: null | number

The initial rate_limit_per_user to set on newly created threads in a channel. This field is copied to the thread at creation time and does not live update

Channel types: text, forum, media

optionalflags

flags?: ChannelFlags

Channel flags combined as a bit field.

optionalinvitable

invitable?: boolean

Whether non-moderators can add other non-moderators to the thread

Channel types: privateThread

optionallocked

locked?: boolean

Whether the thread should be locked

Channel types: newsThread, publicThread, privateThread

optionalname

name?: string

1-100 character channel name

Channel types: all

optionalnsfw

nsfw?: null | boolean

Whether the channel is nsfw

Channel types: text, voice, news, forum, media

optionalparent_id

parent_id?: null | string

ID of the new parent category for a channel

Channel types: text, voice, news, stage, forum, media

optionalpermission_overwrites

permission_overwrites?: null | APIChannelPatchOverwrite[]

Channel or category-specific permissions

Channel types: all excluding newsThread, publicThread, privateThread

optionalposition

position?: null | number

The position of the channel in the left-hand listing

Channel types: all excluding newsThread, publicThread, privateThread

optionalrate_limit_per_user

rate_limit_per_user?: null | number

Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission MANAGE_MESSAGES or MANAGE_CHANNELS, are unaffected

Channel types: text, newsThread, publicThread, privateThread, forum, media

optionalrtc_region

rtc_region?: null | string

Voice region id for the voice or stage channel, automatic when set to null

optionaltopic

topic?: null | string

0-1024 character channel topic (0-4096 characters for thread-only channels)

Channel types: text, news, forum, media

optionaltype

type?: GuildText | GuildAnnouncement

The type of channel; only conversion between text and news is supported and only in guilds with the “NEWS” feature

Channel types: text, news

optionaluser_limit

user_limit?: null | number

The user limit of the voice channel; 0 refers to no limit, 1 to 99 refers to a user limit

Channel types: voice

optionalvideo_quality_mode

video_quality_mode?: null | VideoQualityMode