Skip to content

feat(invite): Guest invites #6247

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jun 30, 2025
Merged

feat(invite): Guest invites #6247

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
1b573eb
feat(invite): Guest invites
elenakrittik Jun 22, 2023
3ac82af
Apply suggestion
elenakrittik Jul 9, 2023
d565e11
Merge branch 'main' into pr/6247
advaith1 Jun 26, 2025
1450840
update flags docs
advaith1 Jun 30, 2025
6c73185
Merge branch 'main' into pr/6247
advaith1 Jun 30, 2025
d2b560d
fix link
advaith1 Jun 30, 2025
754b872
actually fix ci this time
advaith1 Jun 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions docs/resources/guild.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -159,6 +159,7 @@ Fields specific to the `GUILD_CREATE` event are listed in the [Gateway Events do
| VERIFIED | guild is verified |
| VIP_REGIONS | guild has access to set 384kbps bitrate in voice (previously VIP voice servers) |
| WELCOME_SCREEN_ENABLED | guild has enabled the welcome screen |
| GUESTS_ENABLED | guild has access to guest invites |
| ENHANCED_ROLE_COLORS | guild is able to set gradient colors to roles |

###### Mutable Guild Features
Expand Down Expand Up @@ -359,7 +360,7 @@ The fields `id`, `discriminator` and `avatar` are anonymized to prevent abuse.
| avatar? | ?string | the member's [guild avatar hash](/docs/reference#image-formatting) |
| banner? | ?string | the member's [guild banner hash](/docs/reference#image-formatting) |
| roles | array of snowflakes | array of [role](/docs/topics/permissions#role-object) object ids |
| joined_at | ISO8601 timestamp | when the user joined the guild |
| joined_at | ?ISO8601 timestamp | when the user joined the guild |
| premium_since? | ?ISO8601 timestamp | when the user started [boosting](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting-) the guild |
| deaf | boolean | whether the user is deafened in voice channels |
| mute | boolean | whether the user is muted in voice channels |
Expand All @@ -377,6 +378,9 @@ The field `user` won't be included in the member object attached to `MESSAGE_CRE
In `GUILD_` events, `pending` will always be included as true or false. In non `GUILD_` events which can only be triggered by non-`pending` users, `pending` will not be included.
:::

> info
> Member objects retrieved from `VOICE_STATE_UPDATE` events will have `joined_at` set as `null` if the member was invited as a guest.

###### Example Guild Member

```json
Expand Down Expand Up @@ -1511,4 +1515,4 @@ Both `invites_disabled_until` and `dms_disabled_until` can be enabled for a maxi
| invites_disabled_until? | ?ISO8601 timestamp \* | when invites will be enabled again |
| dms_disabled_until? | ?ISO8601 timestamp \* | when direct messages will be enabled again |

\* Supplying `null` disables the action.
\* Supplying `null` disables the action.
7 changes: 7 additions & 0 deletions docs/resources/invite.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ Represents a code that when used, adds a user to a guild or group DM channel.
| expires_at? | ?ISO8601 timestamp | the expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true` |
| stage_instance? | [invite stage instance](/docs/resources/invite#invite-stage-instance-object) object | stage instance data if there is a [public Stage instance](/docs/resources/stage-instance) in the Stage channel this invite is for (deprecated) |
| guild_scheduled_event? | [guild scheduled event](/docs/resources/guild-scheduled-event#guild-scheduled-event-object) object | guild scheduled event data, only included if `guild_scheduled_event_id` contains a valid guild scheduled event id |
| flags? | integer | [guild invite flags](/docs/resources/invite#invite-object-guild-invite-flags) for guild invites |

###### Invite Types

Expand All @@ -41,6 +42,12 @@ Represents a code that when used, adds a user to a guild or group DM channel.
| STREAM | 1 |
| EMBEDDED_APPLICATION | 2 |

###### Guild Invite Flags

| Flag | Value | Description |
|-----------------|----------|---------------------------------------------------|
| IS_GUEST_INVITE | `1 << 0` | this invite is a guest invite for a voice channel |

###### Example Invite Object

```json
Expand Down