Skip to main content
Version: Next

RESTPatchAPIChannelJSONBody

https://discord.com/developers/docs/resources/channel#modify-channel

Index

Properties

Properties

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?: APIGuildForumTag[]

The set of tags that can be used in a forum channel; limited to 20

Channel types: forum

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

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 forum channel

Channel types: forum

optionaldefault_sort_order

default_sort_order?: null | SortOrderType

The default sort order type used to order posts in a forum channel

Channel types: forum

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: forum

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

optionalparent_id

parent_id?: null | string

ID of the new parent category for a channel

Channel types: text, voice, news

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

optionalrtc_region

rtc_region?: null | string

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

See https://discord.com/developers/docs/resources/voice#voice-region-object

optionaltopic

topic?: null | string

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

Channel types: text, news, forum

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

The camera video quality mode of the voice channel

See https://discord.com/developers/docs/resources/channel#channel-object-video-quality-modes