> ## Documentation Index
> Fetch the complete documentation index at: https://discord-platform-username.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Resource

> Reference for Discord voice objects and connection endpoints.

export const Route = ({method, children}) => {
  return <div className="MDXRoute">
      <span className={"verb" + " " + method.toLowerCase()}>{method}</span>
      <span className="url">{children}</span>
    </div>;
};

export const ManualAnchor = ({id}) => {
  return <div className="MDXManualAnchor" id={id}></div>;
};

### Voice State Object

Used to represent a user's voice connection status.

<ManualAnchor id="voice-state-object-voice-state-structure" />

###### Voice State Structure

| Field                         | Type                                                                   | Description                                       |
| ----------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------- |
| guild\_id?                    | snowflake                                                              | the guild id this voice state is for              |
| channel\_id                   | ?snowflake                                                             | the channel id this user is connected to          |
| user\_id                      | snowflake                                                              | the user id this voice state is for               |
| member?                       | [guild member](/developers/resources/guild#guild-member-object) object | the guild member this voice state is for          |
| session\_id                   | string                                                                 | the session id for this voice state               |
| deaf                          | boolean                                                                | whether this user is deafened by the server       |
| mute                          | boolean                                                                | whether this user is muted by the server          |
| self\_deaf                    | boolean                                                                | whether this user is locally deafened             |
| self\_mute                    | boolean                                                                | whether this user is locally muted                |
| self\_stream?                 | boolean                                                                | whether this user is streaming using "Go Live"    |
| self\_video                   | boolean                                                                | whether this user's camera is enabled             |
| suppress                      | boolean                                                                | whether this user's permission to speak is denied |
| request\_to\_speak\_timestamp | ?ISO8601 timestamp                                                     | the time at which the user requested to speak     |

<ManualAnchor id="voice-state-object-example-voice-state" />

###### Example Voice State

```json theme={null}
{
  "channel_id": "157733188964188161",
  "user_id": "80351110224678912",
  "session_id": "90326bd25d71d39b9ef95b299e3872ff",
  "deaf": false,
  "mute": false,
  "self_deaf": false,
  "self_mute": true,
  "suppress": false,
  "request_to_speak_timestamp": "2021-03-31T18:45:31.297561+00:00"
}
```

### Voice Region Object

<ManualAnchor id="voice-region-object-voice-region-structure" />

###### Voice Region Structure

| Field      | Type    | Description                                                           |
| ---------- | ------- | --------------------------------------------------------------------- |
| id         | string  | unique ID for the region                                              |
| name       | string  | name of the region                                                    |
| optimal    | boolean | true for a single server that is closest to the current user's client |
| deprecated | boolean | whether this is a deprecated voice region (avoid switching to these)  |
| custom     | boolean | whether this is a custom voice region (used for events/etc)           |

## List Voice Regions

<Route method="GET">/voice/regions</Route>

Returns an array of [voice region](/developers/resources/voice#voice-region-object) objects that can be used when setting a voice or stage channel's [`rtc_region`](/developers/resources/channel#channel-object-channel-structure).

## Get Current User Voice State

<Route method="GET">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/voice-states/@me</Route>

Returns the current user's [voice state](/developers/resources/voice#voice-state-object) in the guild.

## Get User Voice State

<Route method="GET">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/voice-states/[\{user.id}](/developers/resources/user#user-object)</Route>

Returns the specified user's [voice state](/developers/resources/voice#voice-state-object) in the guild.

## Modify Current User Voice State

<Route method="PATCH">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/voice-states/@me</Route>

Updates the current user's voice state. Returns `204 No Content` on success. Fires a [Voice State Update](/developers/events/gateway-events#voice-state-update) Gateway event.

<ManualAnchor id="modify-current-user-voice-state-json-params" />

###### JSON Params

| Field                          | Type               | Description                                    |
| ------------------------------ | ------------------ | ---------------------------------------------- |
| channel\_id?                   | snowflake          | the id of the channel the user is currently in |
| suppress?                      | boolean            | toggles the user's suppress state              |
| request\_to\_speak\_timestamp? | ?ISO8601 timestamp | sets the user's request to speak               |

<ManualAnchor id="modify-current-user-voice-state-caveats" />

###### Caveats

There are currently several caveats for this endpoint:

* `channel_id` must currently point to a stage channel.
* current user must already have joined `channel_id`.
* You must have the `MUTE_MEMBERS` permission to unsuppress yourself. You can always suppress yourself.
* You must have the `REQUEST_TO_SPEAK` permission to request to speak. You can always clear your own request to speak.
* You are able to set `request_to_speak_timestamp` to any present or future time.

## Modify User Voice State

<Route method="PATCH">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/voice-states/[\{user.id}](/developers/resources/user#user-object)</Route>

Updates another user's voice state. Returns `204 No Content` on success. Fires a [Voice State Update](/developers/events/gateway-events#voice-state-update) Gateway event.

<ManualAnchor id="modify-user-voice-state-json-params" />

###### JSON Params

| Field        | Type      | Description                                    |
| ------------ | --------- | ---------------------------------------------- |
| channel\_id? | snowflake | the id of the channel the user is currently in |
| suppress?    | boolean   | toggles the user's suppress state              |

<ManualAnchor id="modify-user-voice-state-caveats" />

###### Caveats

There are currently several caveats for this endpoint:

* `channel_id` must currently point to a stage channel.
* User must already have joined `channel_id`.
* You must have the `MUTE_MEMBERS` permission. (Since suppression is the only thing that is available currently.)
* When unsuppressed, non-bot users will have their `request_to_speak_timestamp` set to the current time. Bot users will not.
* When suppressed, the user will have their `request_to_speak_timestamp` removed.