dfx 0.0.1

package/discord-api-docs/docs/resources/Stage_Instance.md

@@ -0,0 +1,106 @@
+# Stage Instance Resource
+
+A _Stage Instance_ holds information about a live stage.
+
+### Stage Instance Object
+
+###### Stage Instance Structure
+
+| Field                    | Type       | Description                                                                                                   |
+| ------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------- |
+| id                       | snowflake  | The id of this Stage instance                                                                                 |
+| guild_id                 | snowflake  | The guild id of the associated Stage channel                                                                  |
+| channel_id               | snowflake  | The id of the associated Stage channel                                                                        |
+| topic                    | string     | The topic of the Stage instance (1-120 characters)                                                            |
+| privacy_level            | integer    | The [privacy level](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-privacy-level) of the Stage instance |
+| discoverable_disabled    | boolean    | Whether or not Stage Discovery is disabled (deprecated)                                                       |
+| guild_scheduled_event_id | ?snowflake | The id of the scheduled event for this Stage instance                                                         |
+
+###### Privacy Level
+
+| Level      | Value | Description                                                         |
+| ---------- | ----- | ------------------------------------------------------------------- |
+| PUBLIC     | 1     | The Stage instance is visible publicly. (deprecated)                |
+| GUILD_ONLY | 2     | The Stage instance is visible to only guild members.                |
+
+###### Example Stage Instance
+
+```json
+{
+  "id": "840647391636226060",
+  "guild_id": "197038439483310086",
+  "channel_id": "733488538393510049",
+  "topic": "Testing Testing, 123",
+  "privacy_level": 1,
+  "discoverable_disabled": false,
+  "guild_scheduled_event_id": "947656305244532806"
+}
+```
+
+## Definitions
+
+Below are some definitions related to stages.
+
+- **Liveness:** A Stage channel is considered _live_ when there is an associated stage instance. Conversely, a Stage channel is _not live_ when there is no associated stage instance.
+- **Speakers:** A participant of a Stage channel is a _speaker_ when their [voice state](#DOCS_RESOURCES_VOICE/voice-state-object)
+  is not `suppress`ed, and has no `request_to_speak_timestamp`.
+- **Moderators**: A member of the guild is a _moderator_ of a Stage channel if they have all of the following [permissions](#DOCS_TOPICS_PERMISSIONS/permissions):
+  - `MANAGE_CHANNELS`
+  - `MUTE_MEMBERS`
+  - `MOVE_MEMBERS`
+- **Topic**: This is the blurb that gets shown below the channel's name, among other places.
+- **Public**: A Stage instance is public when it has a `privacy_level` of `PUBLIC`. While a guild has a public Stage instance:
+  - The guild will be lurkable.
+  - Lurkers may join any Stage channel with a public Stage instance.
+  - Users in the Stage can have the Stage show in their [activities](#DOCS_TOPICS_GATEWAY/presence).
+  - [Invites](#DOCS_RESOURCES_INVITE/invite-object) to the Stage channel will have the `stage_instance` field.
+
+## Auto Closing
+
+When a Stage channel has no speakers for a certain period of time (on the order of minutes) it will be automatically deleted.
+
+## Create Stage Instance % POST /stage-instances
+
+Creates a new Stage instance associated to a Stage channel. Returns that [Stage instance](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-stage-instance-structure).
+
+Requires the user to be a moderator of the Stage channel.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.
+
+###### JSON Params
+
+| Field          | Type      | Description                                                                                                                        |
+| -------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| channel_id     | snowflake | The id of the Stage channel                                                                                                        |
+| topic          | string    | The topic of the Stage instance (1-120 characters)                                                                                 |
+| privacy_level? | integer   | The [privacy level](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-privacy-level) of the Stage instance (default GUILD_ONLY) |
+
+## Get Stage Instance % GET /stage-instances/{channel.id#DOCS_RESOURCES_CHANNEL/channel-object}
+
+Gets the stage instance associated with the Stage channel, if it exists.
+
+## Modify Stage Instance % PATCH /stage-instances/{channel.id#DOCS_RESOURCES_CHANNEL/channel-object}
+
+Updates fields of an existing Stage instance. Returns the updated [Stage instance](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-stage-instance-structure).
+
+Requires the user to be a moderator of the Stage channel.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.
+
+###### JSON Params
+
+| Field          | Type    | Description                                                                                                   |
+| -------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
+| topic?         | string  | The topic of the Stage instance (1-120 characters)                                                            |
+| privacy_level? | integer | The [privacy level](#DOCS_RESOURCES_STAGE_INSTANCE/stage-instance-object-privacy-level) of the Stage instance |
+
+## Delete Stage Instance % DELETE /stage-instances/{channel.id#DOCS_RESOURCES_CHANNEL/channel-object}
+
+Deletes the Stage instance. Returns `204 No Content`.
+
+Requires the user to be a moderator of the Stage channel.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.

package/discord-api-docs/docs/resources/Sticker.md

@@ -0,0 +1,164 @@
+# Sticker Resource
+
+### Sticker Object
+
+Represents a sticker that can be sent in messages.
+
+###### Sticker Structure
+
+| Field       | Type                                            | Description                                                                                                                                                          |
+| ----------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| id          | snowflake                                       | [id of the sticker](#DOCS_REFERENCE/image-formatting)                                                                                                                |
+| pack_id?    | snowflake                                       | for standard stickers, id of the pack the sticker is from                                                                                                            |
+| name        | string                                          | name of the sticker                                                                                                                                                  |
+| description | ?string                                         | description of the sticker                                                                                                                                           |
+| tags\*      | string                                          | autocomplete/suggestion tags for the sticker (max 200 characters)                                                                                                    |
+| asset?      | string                                          | **Deprecated** previously the sticker asset hash, now an empty string                                                                                                |
+| type        | integer                                         | [type of sticker](#DOCS_RESOURCES_STICKER/sticker-object-sticker-types)                                                                                              |
+| format_type | integer                                         | [type of sticker format](#DOCS_RESOURCES_STICKER/sticker-object-sticker-format-types)                                                                                |
+| available?  | boolean                                         | whether this guild sticker can be used, may be false due to loss of Server Boosts                                                                                    |
+| guild_id?   | snowflake                                       | id of the guild that owns this sticker                                                                                                                               |
+| user?       | [user](#DOCS_RESOURCES_USER/user-object) object | the user that uploaded the guild sticker                                                                                                                             |
+| sort_value? | integer                                         | the standard sticker's sort order within its pack                                                                                                                    |
+
+\* A comma separated list of keywords is the format used in this field by standard stickers, but this is just a convention.
+Incidentally the client will always use a name generated from an emoji as the value of this field when creating or modifying a guild sticker.
+
+###### Sticker Types
+
+| Type     | Value | Description                                                                   |
+| -------- | ----- | ----------------------------------------------------------------------------- |
+| STANDARD | 1     | an official sticker in a pack, part of Nitro or in a removed purchasable pack |
+| GUILD    | 2     | a sticker uploaded to a Boosted guild for the guild's members                 |
+
+###### Sticker Format Types
+
+| Type   | Value |
+| ------ | ----- |
+| PNG    | 1     |
+| APNG   | 2     |
+| LOTTIE | 3     |
+
+###### Example Sticker
+
+```json
+{
+  "id": "749054660769218631",
+  "name": "Wave",
+  "tags": "wumpus, hello, sup, hi, oi, heyo, heya, yo, greetings, greet, welcome, wave, :wave, :hello, :hi, :hey, hey, \ud83d\udc4b, \ud83d\udc4b\ud83c\udffb, \ud83d\udc4b\ud83c\udffc, \ud83d\udc4b\ud83c\udffd, \ud83d\udc4b\ud83c\udffe, \ud83d\udc4b\ud83c\udfff, goodbye, bye, see ya, later, laterz, cya",
+  "type": 1,
+  "format_type": 3,
+  "description": "Wumpus waves hello",
+  "asset": "",
+  "pack_id": "847199849233514549",
+  "sort_value": 12
+}
+```
+
+### Sticker Item Object
+
+The smallest amount of data required to render a sticker. A partial sticker object.
+
+###### Sticker Item Structure
+
+| Field       | Type      | Description                                                                           |
+| ----------- | --------- | ------------------------------------------------------------------------------------- |
+| id          | snowflake | id of the sticker                                                                     |
+| name        | string    | name of the sticker                                                                   |
+| format_type | integer   | [type of sticker format](#DOCS_RESOURCES_STICKER/sticker-object-sticker-format-types) |
+
+### Sticker Pack Object
+
+Represents a pack of standard stickers.
+
+###### Sticker Pack Structure
+
+| Field             | Type                                                               | Description                                                               |
+| ----------------  | ------------------------------------------------------------------ | ------------------------------------------------------------------------- |
+| id                | snowflake                                                          | id of the sticker pack                                                    |
+| stickers          | array of [sticker](#DOCS_RESOURCES_STICKER/sticker-object) objects | the stickers in the pack                                                  |
+| name              | string                                                             | name of the sticker pack                                                  |
+| sku_id            | snowflake                                                          | id of the pack's SKU                                                      |
+| cover_sticker_id? | snowflake                                                          | id of a sticker in the pack which is shown as the pack's icon             |
+| description       | string                                                             | description of the sticker pack                                           |
+| banner_asset_id?  | snowflake                                                          | id of the sticker pack's [banner image](#DOCS_REFERENCE/image-formatting) |
+
+###### Example Sticker Pack
+
+```json
+{
+  "id": "847199849233514549",
+  "stickers": [],
+  "name": "Wumpus Beyond",
+  "sku_id": "847199849233514547",
+  "cover_sticker_id": "749053689419006003",
+  "description": "Say hello to Wumpus!",
+  "banner_asset_id": "761773777976819732"
+}
+```
+
+## Get Sticker % GET /stickers/{sticker.id#DOCS_RESOURCES_STICKER/sticker-object}
+
+Returns a [sticker](#DOCS_RESOURCES_STICKER/sticker-object) object for the given sticker ID.
+
+## List Nitro Sticker Packs % GET /sticker-packs
+
+Returns the list of sticker packs available to Nitro subscribers.
+
+###### Response Structure
+
+| Field         | Type                                                                         |
+| ------------- | ---------------------------------------------------------------------------- |
+| sticker_packs | array of [sticker pack](#DOCS_RESOURCES_STICKER/sticker-pack-object) objects |
+
+## List Guild Stickers % GET /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/stickers
+
+Returns an array of [sticker](#DOCS_RESOURCES_STICKER/sticker-object) objects for the given guild. Includes `user` fields if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+
+## Get Guild Sticker % GET /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/stickers/{sticker.id#DOCS_RESOURCES_STICKER/sticker-object}
+
+Returns a [sticker](#DOCS_RESOURCES_STICKER/sticker-object) object for the given guild and sticker IDs. Includes the `user` field if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+
+## Create Guild Sticker % POST /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/stickers
+
+Create a new sticker for the guild. Send a `multipart/form-data` body. Requires the `MANAGE_EMOJIS_AND_STICKERS` permission. Returns the new [sticker](#DOCS_RESOURCES_STICKER/sticker-object) object on success.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.
+
+> warn
+> Lottie stickers can only be uploaded on guilds that have either the `VERIFIED` and/or the `PARTNERED` [guild feature](#DOCS_RESOURCES_GUILD/guild-object-guild-features). 
+
+###### Form Params
+
+| Field       | Type          | Description                                                                                  |
+| ----------- | ------------- | -------------------------------------------------------------------------------------------- |
+| name        | string        | name of the sticker (2-30 characters)                                                        |
+| description | string        | description of the sticker (empty or 2-100 characters)                                       |
+| tags        | string        | autocomplete/suggestion tags for the sticker (max 200 characters)                            |
+| file        | file contents | the sticker file to upload, must be a PNG, APNG, or Lottie JSON file, max 500 KB             |
+
+## Modify Guild Sticker % PATCH /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/stickers/{sticker.id#DOCS_RESOURCES_STICKER/sticker-object}
+
+Modify the given sticker. Requires the `MANAGE_EMOJIS_AND_STICKERS` permission. Returns the updated [sticker](#DOCS_RESOURCES_STICKER/sticker-object) object on success.
+
+> info
+> All parameters to this endpoint are optional.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.
+
+###### JSON Params
+
+| Field       | Type    | Description                                                                                  |
+| ----------- | ------- | -------------------------------------------------------------------------------------------- |
+| name        | string  | name of the sticker (2-30 characters)                                                        |
+| description | ?string | description of the sticker (2-100 characters)                                                |
+| tags        | string  | autocomplete/suggestion tags for the sticker (max 200 characters)                            |
+
+## Delete Guild Sticker % DELETE /guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/stickers/{sticker.id#DOCS_RESOURCES_STICKER/sticker-object}
+
+Delete the given sticker. Requires the `MANAGE_EMOJIS_AND_STICKERS` permission. Returns `204 No Content` on success.
+
+> info
+> This endpoint supports the `X-Audit-Log-Reason` header.

package/discord-api-docs/docs/resources/User.md

@@ -0,0 +1,205 @@
+# Users Resource
+
+Users in Discord are generally considered the base entity. Users can spawn across the entire platform, be members of
+guilds, participate in text and voice chat, and much more. Users are separated by a distinction of "bot" vs "normal." Although they are similar, bot users are automated users that are "owned" by another user. Unlike normal users, bot users do
+_not_ have a limitation on the number of Guilds they can be a part of.
+
+## Usernames and Nicknames
+
+Discord enforces the following restrictions for usernames and nicknames:
+
+1.  Names can contain most valid unicode characters. We limit some zero-width and non-rendering characters.
+2.  Usernames must be between 2 and 32 characters long.
+3.  Nicknames must be between 1 and 32 characters long.
+4.  Names are sanitized and trimmed of leading, trailing, and excessive internal whitespace.
+
+The following restrictions are additionally enforced for usernames:
+
+1.  Usernames cannot contain the following substrings: '@', '#', ':', '\```', 'discord'
+2.  Usernames cannot be: 'everyone', 'here'
+
+There are other rules and restrictions not shared here for the sake of spam and abuse mitigation, but the majority of users won't encounter them. It's important to properly handle all error messages returned by Discord when editing or updating names.
+
+### User Object
+
+###### User Structure
+
+| Field         | Type      | Description                                                                                          | Required OAuth2 Scope |
+| ------------- | --------- | ---------------------------------------------------------------------------------------------------- | --------------------- |
+| id            | snowflake | the user's id                                                                                        | identify              |
+| username      | string    | the user's username, not unique across the platform                                                  | identify              |
+| discriminator | string    | the user's 4-digit discord-tag                                                                       | identify              |
+| avatar        | ?string   | the user's [avatar hash](#DOCS_REFERENCE/image-formatting)                                           | identify              |
+| bot?          | boolean   | whether the user belongs to an OAuth2 application                                                    | identify              |
+| system?       | boolean   | whether the user is an Official Discord System user (part of the urgent message system)              | identify              |
+| mfa_enabled?  | boolean   | whether the user has two factor enabled on their account                                             | identify              |
+| banner?       | ?string   | the user's [banner hash](#DOCS_REFERENCE/image-formatting)                                           | identify              |
+| accent_color? | ?integer  | the user's banner color encoded as an integer representation of hexadecimal color code               | identify              |
+| locale?       | string    | the user's chosen [language option](#DOCS_REFERENCE/locales)                                         | identify              |
+| verified?     | boolean   | whether the email on this account has been verified                                                  | email                 |
+| email?        | ?string   | the user's email                                                                                     | email                 |
+| flags?        | integer   | the [flags](#DOCS_RESOURCES_USER/user-object-user-flags) on a user's account                         | identify              |
+| premium_type? | integer   | the [type of Nitro subscription](#DOCS_RESOURCES_USER/user-object-premium-types) on a user's account | identify              |
+| public_flags? | integer   | the public [flags](#DOCS_RESOURCES_USER/user-object-user-flags) on a user's account                  | identify              |
+
+###### Example User
+
+```json
+{
+  "id": "80351110224678912",
+  "username": "Nelly",
+  "discriminator": "1337",
+  "avatar": "8342729096ea3675442027381ff50dfe",
+  "verified": true,
+  "email": "nelly@discord.com",
+  "flags": 64,
+  "banner": "06c16474723fe537c283b8efa61a30c8",
+  "accent_color": 16711680,
+  "premium_type": 1,
+  "public_flags": 64
+}
+```
+
+###### User Flags
+
+| Value   | Name                     | Description                                                                                                                                    |
+| ------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| 0       | None                     | None                                                                                                                                           |
+| 1 << 0  | STAFF                    | Discord Employee                                                                                                                               |
+| 1 << 1  | PARTNER                  | Partnered Server Owner                                                                                                                         |
+| 1 << 2  | HYPESQUAD                | HypeSquad Events Coordinator                                                                                                                   |
+| 1 << 3  | BUG_HUNTER_LEVEL_1       | Bug Hunter Level 1                                                                                                                             |
+| 1 << 6  | HYPESQUAD_ONLINE_HOUSE_1 | House Bravery Member                                                                                                                           |
+| 1 << 7  | HYPESQUAD_ONLINE_HOUSE_2 | House Brilliance Member                                                                                                                        |
+| 1 << 8  | HYPESQUAD_ONLINE_HOUSE_3 | House Balance Member                                                                                                                           |
+| 1 << 9  | PREMIUM_EARLY_SUPPORTER  | Early Nitro Supporter                                                                                                                          |
+| 1 << 10 | TEAM_PSEUDO_USER         | User is a [team](#DOCS_TOPICS_TEAMS/)                                                                                                          |
+| 1 << 14 | BUG_HUNTER_LEVEL_2       | Bug Hunter Level 2                                                                                                                             |
+| 1 << 16 | VERIFIED_BOT             | Verified Bot                                                                                                                                   |
+| 1 << 17 | VERIFIED_DEVELOPER       | Early Verified Bot Developer                                                                                                                   |
+| 1 << 18 | CERTIFIED_MODERATOR      | Discord Certified Moderator                                                                                                                    |
+| 1 << 19 | BOT_HTTP_INTERACTIONS    | Bot uses only [HTTP interactions](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/receiving-an-interaction) and is shown in the online member list |
+
+###### Premium Types
+
+Premium types denote the level of premium a user has. Visit the [Nitro](https://discord.com/nitro) page to learn more about the premium plans we currently offer.
+
+| Value | Name          |
+| ----- | ------------- |
+| 0     | None          |
+| 1     | Nitro Classic |
+| 2     | Nitro         |
+
+### Connection Object
+
+The connection object that the user has attached.
+
+###### Connection Structure
+
+| Field         | Type    | Description                                                                              |
+| ------------- | ------- | ---------------------------------------------------------------------------------------- |
+| id            | string  | id of the connection account                                                             |
+| name          | string  | the username of the connection account                                                   |
+| type          | string  | the service of the connection (twitch, youtube)                                          |
+| revoked?      | boolean | whether the connection is revoked                                                        |
+| integrations? | array   | an array of partial [server integrations](#DOCS_RESOURCES_GUILD/integration-object)      |
+| verified      | boolean | whether the connection is verified                                                       |
+| friend_sync   | boolean | whether friend sync is enabled for this connection                                       |
+| show_activity | boolean | whether activities related to this connection will be shown in presence updates          |
+| visibility    | integer | [visibility](#DOCS_RESOURCES_USER/connection-object-visibility-types) of this connection |
+
+###### Visibility Types
+
+| Value | Name     | Description                                      |
+| ----- | -------- | ------------------------------------------------ |
+| 0     | None     | invisible to everyone except the user themselves |
+| 1     | Everyone | visible to everyone                              |
+
+## Get Current User % GET /users/@me
+
+Returns the [user](#DOCS_RESOURCES_USER/user-object) object of the requester's account. For OAuth2, this requires the `identify` scope, which will return the object _without_ an email, and optionally the `email` scope, which returns the object _with_ an email.
+
+## Get User % GET /users/{user.id#DOCS_RESOURCES_USER/user-object}
+
+Returns a [user](#DOCS_RESOURCES_USER/user-object) object for a given user ID.
+
+## Modify Current User % PATCH /users/@me
+
+Modify the requester's user account settings. Returns a [user](#DOCS_RESOURCES_USER/user-object) object on success.
+
+> info
+> All parameters to this endpoint are optional.
+
+###### JSON Params
+
+| Field    | Type                                      | Description                                                                      |
+| -------- | ----------------------------------------- | -------------------------------------------------------------------------------- |
+| username | string                                    | user's username, if changed may cause the user's discriminator to be randomized. |
+| avatar   | ?[image data](#DOCS_REFERENCE/image-data) | if passed, modifies the user's avatar                                            |
+
+## Get Current User Guilds % GET /users/@me/guilds
+
+Returns a list of partial [guild](#DOCS_RESOURCES_GUILD/guild-object) objects the current user is a member of. Requires the `guilds` OAuth2 scope.
+
+###### Example Partial Guild
+
+```json
+{
+  "id": "80351110224678912",
+  "name": "1337 Krew",
+  "icon": "8342729096ea3675442027381ff50dfe",
+  "owner": true,
+  "permissions": "36953089",
+  "features": ["COMMUNITY", "NEWS"]
+}
+```
+
+> info
+> This endpoint returns 200 guilds by default, which is the maximum number of guilds a non-bot user can join. Therefore, pagination is **not needed** for integrations that need to get a list of the users' guilds.
+
+###### Query String Params
+
+| Field  | Type      | Description                            | Required | Default |
+| ------ | --------- | -------------------------------------- | -------- | ------- |
+| before | snowflake | get guilds before this guild ID        | false    | absent  |
+| after  | snowflake | get guilds after this guild ID         | false    | absent  |
+| limit  | integer   | max number of guilds to return (1-200) | false    | 200     |
+
+## Get Current User Guild Member % GET /users/@me/guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}/member
+
+Returns a [guild member](#DOCS_RESOURCES_GUILD/guild-member-object) object for the current user. Requires the `guilds.members.read` OAuth2 scope.
+
+## Leave Guild % DELETE /users/@me/guilds/{guild.id#DOCS_RESOURCES_GUILD/guild-object}
+
+Leave a guild. Returns a 204 empty response on success.
+
+## Create DM % POST /users/@me/channels
+
+Create a new DM channel with a user. Returns a [DM channel](#DOCS_RESOURCES_CHANNEL/channel-object) object.
+
+> warn
+> You should not use this endpoint to DM everyone in a server about something. DMs should generally be initiated by a user action. If you open a significant amount of DMs too quickly, your bot may be rate limited or blocked from opening new ones.
+
+###### JSON Params
+
+| Field        | Type      | Description                             |
+| ------------ | --------- | --------------------------------------- |
+| recipient_id | snowflake | the recipient to open a DM channel with |
+
+## Create Group DM % POST /users/@me/channels
+
+Create a new group DM channel with multiple users. Returns a [DM channel](#DOCS_RESOURCES_CHANNEL/channel-object) object. This endpoint was intended to be used with the now-deprecated GameBridge SDK. DMs created with this endpoint will not be shown in the Discord client
+
+> warn
+> This endpoint is limited to 10 active group DMs.
+
+###### JSON Params
+
+| Field         | Type             | Description                                                            |
+| ------------- | ---------------- | ---------------------------------------------------------------------- |
+| access_tokens | array of strings | access tokens of users that have granted your app the `gdm.join` scope |
+| nicks         | dict             | a dictionary of user ids to their respective nicknames                 |
+
+## Get User Connections % GET /users/@me/connections
+
+Returns a list of [connection](#DOCS_RESOURCES_USER/connection-object) objects. Requires the `connections` OAuth2 scope.

package/discord-api-docs/docs/resources/Voice.md

@@ -0,0 +1,55 @@
+# Voice Resource
+
+### Voice State Object
+
+Used to represent a user's voice connection status.
+
+###### 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](#DOCS_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 is muted by the current user |
+| request_to_speak_timestamp | ?ISO8601 timestamp                                               | the time at which the user requested to speak  |
+
+###### Example Voice State
+
+```json
+{
+  "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
+
+###### 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 % GET /voice/regions
+
+Returns an array of [voice region](#DOCS_RESOURCES_VOICE/voice-region-object) objects that can be used when setting a voice or stage channel's [`rtc_region`](#DOCS_RESOURCES_CHANNEL/channel-object-channel-structure).