--- title: "PATCH /channels/{channel_id}" method: PATCH path: "/channels/{channel_id}" --- # PATCH /channels/{channel_id} `PATCH /channels/{channel_id}` ## Request body - union - object - `name` string, nullable - object - `name` string, nullable - `icon` string, byte, nullable - object - `type` union - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `name` string - `position` integer, nullable - `topic` string, nullable - `bitrate` integer, nullable - `user_limit` integer, nullable - `nsfw` boolean, nullable - `rate_limit_per_user` integer, nullable - `parent_id` string, snowflake - `permission_overwrites` ChannelPermissionOverwriteRequest[], nullable - `id` string, snowflake, required - `type` union - 0 - 1 - `allow` integer, nullable - `deny` integer, nullable - `rtc_region` string, nullable - `video_quality_mode` union - 1 — Discord chooses the quality for optimal performance - 2 — 720p - `default_auto_archive_duration` union - 60 — One hour - 1440 — One day - 4320 — Three days - 10080 — Seven days - `default_reaction_emoji` UpdateDefaultReactionEmojiRequest - `emoji_id` string, snowflake - `emoji_name` string, nullable - `default_thread_rate_limit_per_user` integer, nullable - `default_sort_order` union - 0 — Sort forum posts by activity - 1 — Sort forum posts by creation time (from most recent to oldest) - `default_forum_layout` union - 0 — No default has been set for forum channel - 1 — Display posts as a list - 2 — Display posts as a collection of tiles - `default_tag_setting` union - 'match_all' — The thread tags must contain all tags in the search query - 'match_some' — The thread tags must contain at least one of tags in the search query - `flags` integer, nullable - `available_tags` UpdateThreadTagRequest[], nullable - `name` string, required - `emoji_id` string, snowflake - `emoji_name` string, nullable - `moderated` boolean, nullable - `id` string, snowflake - object - `name` string, nullable - `archived` boolean, nullable - `locked` boolean, nullable - `invitable` boolean, nullable - `auto_archive_duration` union - 60 — One hour - 1440 — One day - 4320 — Three days - 10080 — Seven days - `rate_limit_per_user` integer, nullable - `flags` integer, nullable - `applied_tags` SnowflakeType[], nullable - `bitrate` integer, nullable - `user_limit` integer, nullable - `rtc_region` string, nullable - `video_quality_mode` union - 1 — Discord chooses the quality for optimal performance - 2 — 720p ## Response `200` 200 response for update_channel - union - GuildChannelResponse - `id` string, snowflake, required - `type` union, required - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `last_message_id` string, snowflake - `flags` integer, required - `last_pin_timestamp` string, date-time, nullable - `guild_id` string, snowflake, required - `name` string, required - `parent_id` string, snowflake - `rate_limit_per_user` integer - `bitrate` integer - `user_limit` integer - `rtc_region` string, nullable - `video_quality_mode` union - 1 — Discord chooses the quality for optimal performance - 2 — 720p - `permissions` string - `topic` string, nullable - `default_auto_archive_duration` union - 60 — One hour - 1440 — One day - 4320 — Three days - 10080 — Seven days - `default_thread_rate_limit_per_user` integer - `position` integer, required - `permission_overwrites` ChannelPermissionOverwriteResponse[] - `id` string, snowflake, required - `type` union, required - 0 - 1 - `allow` string, required - `deny` string, required - `nsfw` boolean - `available_tags` ForumTagResponse[] - `id` string, snowflake, required - `name` string, required - `moderated` boolean, required - `emoji_id` string, snowflake, required - `emoji_name` string, nullable, required - `default_reaction_emoji` DefaultReactionEmojiResponse - `emoji_id` string, snowflake, required - `emoji_name` string, nullable, required - `default_sort_order` union - 0 — Sort forum posts by activity - 1 — Sort forum posts by creation time (from most recent to oldest) - `default_forum_layout` union - 0 — No default has been set for forum channel - 1 — Display posts as a list - 2 — Display posts as a collection of tiles - `default_tag_setting` union - 'match_all' — The thread tags must contain all tags in the search query - 'match_some' — The thread tags must contain at least one of tags in the search query - PrivateChannelResponse - `id` string, snowflake, required - `type` union, required - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `last_message_id` string, snowflake - `flags` integer, required - `last_pin_timestamp` string, date-time, nullable - `recipients` UserResponse[], required - `id` string, snowflake, required - `username` string, required — the user's username, not unique across the platform - `avatar` string, nullable, required — the user's avatar hash - `discriminator` string, required — the user's Discord-tag - `public_flags` integer, required — the public flags on a user's account - `flags` integer, required - `bot` boolean — whether the user belongs to an OAuth2 application - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system) - `banner` string, nullable — the user's banner hash - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code - `global_name` string, nullable, required — the user's display name, if it is set - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - `sku_id` string, snowflake, required - `asset` string, required — Path to the nameplate asset - `label` string, required — The label of this nameplate. Currently unused - `palette` union, required - 'crimson' — Crimson color palette - 'berry' — Berry color palette - 'sky' — Sky color palette - 'teal' — Teal color palette - 'forest' — Forest color palette - 'bubble_gum' — Bubble gum color palette - 'violet' — Violet color palette - 'cobalt' — Cobalt color palette - 'clover' — Clover color palette - 'lemon' — Lemon color palette - 'white' — White color palette - 'black' — Black color palette - `primary_guild` UserPrimaryGuildResponse, required - `identity_guild_id` string, snowflake, required - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters - `badge` string, nullable, required — the server tag badge hash - PrivateGroupChannelResponse - `id` string, snowflake, required - `type` union, required - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `last_message_id` string, snowflake - `flags` integer, required - `last_pin_timestamp` string, date-time, nullable - `recipients` UserResponse[], required - `id` string, snowflake, required - `username` string, required — the user's username, not unique across the platform - `avatar` string, nullable, required — the user's avatar hash - `discriminator` string, required — the user's Discord-tag - `public_flags` integer, required — the public flags on a user's account - `flags` integer, required - `bot` boolean — whether the user belongs to an OAuth2 application - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system) - `banner` string, nullable — the user's banner hash - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code - `global_name` string, nullable, required — the user's display name, if it is set - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - `sku_id` string, snowflake, required - `asset` string, required — Path to the nameplate asset - `label` string, required — The label of this nameplate. Currently unused - `palette` union, required - 'crimson' — Crimson color palette - 'berry' — Berry color palette - 'sky' — Sky color palette - 'teal' — Teal color palette - 'forest' — Forest color palette - 'bubble_gum' — Bubble gum color palette - 'violet' — Violet color palette - 'cobalt' — Cobalt color palette - 'clover' — Clover color palette - 'lemon' — Lemon color palette - 'white' — White color palette - 'black' — Black color palette - `primary_guild` UserPrimaryGuildResponse, required - `identity_guild_id` string, snowflake, required - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters - `badge` string, nullable, required — the server tag badge hash - `name` string, nullable, required - `icon` string, nullable, required - `owner_id` string, snowflake, required - `managed` boolean - `application_id` string, snowflake - ThreadResponse - `id` string, snowflake, required - `type` union, required - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `last_message_id` string, snowflake - `flags` integer, required - `last_pin_timestamp` string, date-time, nullable - `guild_id` string, snowflake, required - `name` string, required - `parent_id` string, snowflake - `rate_limit_per_user` integer - `bitrate` integer - `user_limit` integer - `rtc_region` string, nullable - `video_quality_mode` union - 1 — Discord chooses the quality for optimal performance - 2 — 720p - `permissions` string - `owner_id` string, snowflake, required - `thread_metadata` ThreadMetadataResponse, required - `archived` boolean, required - `archive_timestamp` string, date-time, nullable, required - `auto_archive_duration` union, required - 60 — One hour - 1440 — One day - 4320 — Three days - 10080 — Seven days - `locked` boolean, required - `create_timestamp` string, date-time - `invitable` boolean - `message_count` integer, required - `member_count` integer, required - `total_message_sent` integer, required - `applied_tags` SnowflakeType[] - `member` ThreadMemberResponse - `id` string, snowflake, required - `user_id` string, snowflake, required - `join_timestamp` string, date-time, required - `flags` integer, required - `member` GuildMemberResponse - `avatar` string, nullable, required — the member's guild avatar hash - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `banner` string, nullable, required — the member's guild banner hash - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out - `flags` integer, required — guild member flags represented as a bit set, defaults to 0 - `joined_at` string, date-time, required — when the user joined the guild - `nick` string, nullable, required — this user's guild nickname - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements - `premium_since` string, date-time, nullable, required — when the user started boosting the guild - `roles` SnowflakeType[], required — array of role object ids - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - `sku_id` string, snowflake, required - `asset` string, required — Path to the nameplate asset - `label` string, required — The label of this nameplate. Currently unused - `palette` union, required - … - `user` UserResponse, required - `id` string, snowflake, required - `username` string, required — the user's username, not unique across the platform - `avatar` string, nullable, required — the user's avatar hash - `discriminator` string, required — the user's Discord-tag - `public_flags` integer, required — the public flags on a user's account - `flags` integer, required - `bot` boolean — whether the user belongs to an OAuth2 application - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system) - `banner` string, nullable — the user's banner hash - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code - `global_name` string, nullable, required — the user's display name, if it is set - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - … - `primary_guild` UserPrimaryGuildResponse, required - `identity_guild_id` string, snowflake, required - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters - `badge` string, nullable, required — the server tag badge hash - `mute` boolean, required — whether the user is muted in voice channels - `deaf` boolean, required — whether the user is deafened in voice channels ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response --- [API](https://skmtc.net/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.net/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/versions/f6cd197cbe47/schema)