From a67e0eb4a56a5e6da86a1f46e71785ff710be62b Mon Sep 17 00:00:00 2001 From: advaith Date: Mon, 4 Sep 2023 01:51:58 -0700 Subject: [PATCH] Document Set Voice Channel Status endpoint --- docs/resources/Channel.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/resources/Channel.md b/docs/resources/Channel.md index 661a87faf8..ea4b5a85ba 100644 --- a/docs/resources/Channel.md +++ b/docs/resources/Channel.md @@ -987,6 +987,19 @@ Otherwise, requires the `MANAGE_THREADS` permission. Fires a [Thread Update](#DO | flags? | integer | [channel flags](#DOCS_RESOURCES_CHANNEL/channel-object-channel-flags) combined as a [bitfield](https://en.wikipedia.org/wiki/Bit_field); `PINNED` can only be set for threads in forum and media channels | | applied_tags? | array of snowflakes | the IDs of the set of tags that have been applied to a thread in a `GUILD_FORUM` or a `GUILD_MEDIA` channel; limited to 5 | +## Set Voice Channel Status % PUT /channels/{channel.id#DOCS_RESOURCES_CHANNEL/channel-object}/voice-status + +Set a voice channel's status. Requires the `SET_VOICE_CHANNEL_STATUS` permission, and additionally the `MANAGE_CHANNELS` permission if the current user is not connected to the voice channel. Returns a 204 empty response on success. Fires a [Voice Channel Status Update](#DOCS_TOPICS_GATEWAY_EVENTS/voice-channel-status-update) Gateway event. + +> info +> This endpoint supports the `X-Audit-Log-Reason` header. + +###### JSON Params + +| Field | Type | Description | +|--------|---------|-------------------------------------------------| +| status | ?string | new voice channel status (up to 500 characters) | + ## Delete/Close Channel % DELETE /channels/{channel.id#DOCS_RESOURCES_CHANNEL/channel-object} Delete a channel, or close a private message. Requires the `MANAGE_CHANNELS` permission for the guild, or `MANAGE_THREADS` if the channel is a thread. Deleting a category does not delete its child channels; they will have their `parent_id` removed and a [Channel Update](#DOCS_TOPICS_GATEWAY_EVENTS/channel-update) Gateway event will fire for each of them. Returns a [channel](#DOCS_RESOURCES_CHANNEL/channel-object) object on success. Fires a [Channel Delete](#DOCS_TOPICS_GATEWAY_EVENTS/channel-delete) Gateway event (or [Thread Delete](#DOCS_TOPICS_GATEWAY_EVENTS/thread-delete) if the channel was a thread).