discord-is.fun: discord-api-docs pull requests

Opened #8708: Clarify voice clients should only select a protocol once per session

Thu, 05 Nov 2026 23:28:13 GMT

By colinloretz

Add warning to Select Protocol example and add note to start a new session on 4006

Opened #8705: Note that only app-owned webhooks can use app emojis

Thu, 05 Nov 2026 07:37:00 GMT

By materwelonDhruv

a webhook made from a channel's settings shows app emojis as text like :dot:. the same emoji renders fine when the bot creates the webhook itself.

Merged #8701: Flatten stylesheets for js snippets

Mon, 02 Nov 2026 22:15:57 GMT

By colinloretz

Mintlify is silently dropping nested styles

Merged #8444: add IS_COMPONENTS_V2 as allowed flag for thread starting message

Mon, 02 Nov 2026 21:55:00 GMT

By folospior

The Start Thread in Forum or Media Channel endpoint only documented two flags as allowed for the starting message. I didn't verify the others, but I verified IS_COMPONENTS_V2, and it definitely works…

Merged #8421: Removed redundant optional mark from flags and applied_tags fields

Mon, 02 Nov 2026 21:29:55 GMT

By TakemiSora

The Modify Channel endpoint notes that all parameters are optional, but the flags and applied_tags thread fields are additionally marked with a ? suffix. This seems redundant and inconsistent with th…

Merged #8695: Document role / member permission endpoints for guilds / channel

Sat, 31 Oct 2026 00:47:01 GMT

By Lulalaby

As requested by @anthonydiscord This also fixes the previous changelogs missing "developer resources" header

Merged #8427: Delete message doesn't support audit log

Sat, 31 Oct 2026 00:33:47 GMT

By RiskyMH

Message delete by bots aren't added to audit log, even if you specify the audit log header. I can understand the reasoning behind why users get it but not bots, so I think this should be removed to r…

Merged #8303: Document app role connection platform_username

Sat, 31 Oct 2026 00:03:18 GMT

By advaith1

This was included in the PUT request body but not the response object.

Merged #8470: Remove Content-Type note for webhook events

Sat, 31 Oct 2026 00:02:00 GMT

By Xirado

Removed the note about the requirement of Content-Type when responding to PING in webhook events, as you're supposed to respond with 204 so this can't apply. This was probably accidentally left in af…

Merged #8699: Fix lint-staged for markdown files

Fri, 30 Oct 2026 23:53:07 GMT

By colinloretz

Merged #8698: Update dependencies 10/30

Fri, 30 Oct 2026 23:48:54 GMT

By colinloretz

- bump brace-expansion - add esbuild and fsevents to allowScripts - fix two broken links found in CI

Merged #8696: Voice Channel Status Permission Clarification

Thu, 29 Oct 2026 22:15:18 GMT

By colinloretz

Users already connected to a voice channel can now set the channel's status with the SET_VOICE_CHANNEL_STATUS permission even if they do not have CONNECT. Previously, a denied CONNECT implicitly remo…

Merged #8692: Remove flags from Modify Guild Channel Positions

Thu, 29 Oct 2026 20:26:12 GMT

By advaith1

This was a mistake in #8465, this endpoint does not take a flags field.

Merged #8691: Channel and Role Position Update Audit Logs

Thu, 29 Oct 2026 20:20:12 GMT

By advaith1

Adds docs for CHANNEL_POSITION_UPDATE and ROLE_POSITION_UPDATE audit logs Adds docs for audit log entry merging Adds audit log reason note to Modify Guild Channel Positions Adds changelog

Merged #8690: Better document unavailable guilds

Thu, 29 Oct 2026 19:49:09 GMT

By colinloretz

Issue #8683 is expected behavior, so I've updated the docs to be less specific, since a guild might be unavailable for a few reasons. --- Sent when a guild becomes or was already unavailable due to a…

Merged #8687: docs: document content-scanning flags for attachments and embeds

Wed, 28 Oct 2026 22:31:06 GMT

By markmandel

Bots had no documented way to tell whether Discord's content scanning had flagged uploaded media (raised in community PR #8679), so they could end up reposting it into channels where it gets blocked…

Merged #8689: fix: keep YouTube chapter dropdown above page content

Tue, 27 Oct 2026 20:41:05 GMT

By markmandel

The chapters list only had z-10, so positioned page content below it (links, callouts) rendered through the overlay. Set an inline z-index of 50 so it doesn't depend on Mintlify compiling a z-50 util…

Merged #8686: docs: embed Building Game Stats Widgets video on overview page

Tue, 27 Oct 2026 20:16:22 GMT

By markmandel

Included the chapter list, since it's a longer video.

Merged #8682: docs: clarify invite flow for non-linked players

Fri, 23 Oct 2026 16:52:38 GMT

By markmandel. Labels: social-sdk

The Accepting Game Invites section didn't explain how invites work for players who haven't linked a Discord account, which uses RPC to the Discord client if it's available.

Merged #8680: docs: document SetTokenExpirationCallback for full Discord account tokens

Fri, 23 Oct 2026 16:50:40 GMT

By markmandel. Labels: social-sdk

The "Refreshing Access Tokens" section of the account linking guide explained how to refresh an expired access token (server-to-server or via Client::RefreshToken) but not how to know when a refresh…

Merged #8678: docs: document lobby membership change callbacks

Thu, 22 Oct 2026 18:14:45 GMT

By markmandel. Labels: social-sdk

Add a "Tracking Lobby Changes" section to the Managing Lobbies guide covering the callbacks that tell a game when a lobby or its membership changes: - SetLobbyCreatedCallback / SetLobbyDeletedCallbac…

Opened #8685: Add clarity around interaction endpoint rate limits

Wed, 21 Oct 2026 13:08:12 GMT

By RiskyMH

Upon talking to other developers and staff, my understanding is that the Create Interaction Response endpoint is exempt from all rate limits, while the subsequent follow-up endpoints (using /webhooks…

Merged #8669: docs: document 180s game invite join window after cold launch

Mon, 19 Oct 2026 21:47:26 GMT

By markmandel

When a player accepts a game invite and the game isn't running, Discord launches it and holds the pending join until the Social SDK connects. That window was raised from 60 to 180 seconds, and it was…

Merged #8668: OAuth now includes `iss`

Fri, 16 Oct 2026 18:48:19 GMT

By anthonydiscord

OAuth2 authorization responses that redirect to your redirect_uri now include an iss parameter set to https://discord.com, following RFC 9207. Our authorization server metadata (https://discord.com/.…

Merged #8659: docs: port remaining content from the SDK doxygen installation page

Fri, 09 Oct 2026 18:05:18 GMT

By markmandel. Labels: social-sdk

Things that were missing and added: - C++ guide: explain that the C++ SDK is a header-only wrapper over the C API, and that DISCORDPP_IMPLEMENTATION must be defined in exactly one source file before…

Merged #8658: docs: port remaining content from the SDK doxygen getting started page

Fri, 09 Oct 2026 17:10:13 GMT

By markmandel. Labels: social-sdk

Most was already there, except for a few small improvements that made it's way across: - Reusing a stored token: account-linking-with-discord now says to keep tokens in secure, durable storage and to…

Merged #8649: docs: port remaining content from the SDK doxygen authentication page

Wed, 07 Oct 2026 19:06:41 GMT

By markmandel. Labels: social-sdk

Things that were missing and added / fixed: - Account linking: describe where the OAuth2 modal appears on Windows (overlay, Discord client, or browser) and document SetGameWindowPid. - Provisional ac…

Merged #8651: Update name of getActivityInstanceConnectedParticipants

Wed, 07 Oct 2026 02:51:20 GMT

By advaith1

getInstanceConnectedParticipants was renamed to getActivityInstanceConnectedParticipants last year or so but was never documented. The old name is present in current versions for backwards compatibil…

Merged #8606: Document link previews

Tue, 06 Oct 2026 22:27:51 GMT

By anthonydiscord

Adds a new Link Previews section for website devs who want to control how their links look in Discord, and documents component embeds, the new way to replace the standard Open Graph card with a layou…

Merged #8653: Fix Monospace component

Tue, 06 Oct 2026 22:19:02 GMT

By anthonydiscord

This component carried over from pre-mintlify and caused these signatures to fail to render. Updated the css for this component so it works similarly to a code block. <img width="785" height="392" al…

Opened #8650: Remove obsolete node-fetch usages in favor of native Fetch API

Tue, 06 Oct 2026 00:29:10 GMT

By DivyaRaval1909

Fixes #8645 Modern versions of Node.js (v18+) and serverless runtimes (such as Cloudflare Workers) natively support the global fetch API. The sample repositories (discord/discord-example-app and disc…

Merged #8644: docs: note provisional accounts only receive DMs while in-game

Mon, 05 Oct 2026 18:32:02 GMT

By markmandel. Labels: social-sdk

Provisional accounts can only receive DMs from Discord friends while the player is actively in the game, but This was previously stated only in the unmerging guide's data migration section, which was…

Merged #8643: docs: document global vs per-call voice control override behavior

Fri, 02 Oct 2026 22:17:20 GMT

By markmandel. Labels: social-sdk

Global (Client-level) mute/deafen settings override per-call (Call- level) settings.

Merged #8641: Bug: Refresh the playlist carousel's cached video list

Fri, 02 Oct 2026 18:24:11 GMT

By markmandel

The carousel's one-hour cache never expired for the video list, so a playlist edited on YouTube never showed up — the carousel kept rendering whatever it had seen the first time that browser loaded t…

Merged #8638: docs: clarify lobby membership persists after SDK disconnect

Thu, 01 Oct 2026 19:21:47 GMT

By markmandel

Disconnecting the SDK session does not remove a user from a lobby; membership persists until Client::LeaveLobby is explicitly called. Also clarifies that offline/disconnected members still count towa…

Merged #8634: Add audit log permission to get ban endpoints

Wed, 30 Sep 2026 22:24:36 GMT

By advaith1

VIEW_AUDIT_LOG gives permission to get bans, like the gateway events, but this was missing from the docs. fixes #8630

Merged #8604: Add video support to the docs and embed the Discord Developers catalog

Tue, 29 Sep 2026 21:45:54 GMT

By markmandel

Builds out YouTube support for the documentation and uses it to place videos from the Discord Developers channel on the pages they pair with, per the "Video Content in Documentation" plan. Components…

Merged #8626: Document team member user as a full user object

Mon, 28 Sep 2026 23:41:44 GMT

By kwy404

The Team Member Object listed user as a partial user object with only avatar, discriminator, ID, and username, but the API returns a complete user object. The OpenAPI spec agrees, typing TeamMemberRe…

Merged #8627: Explain how to fix lint failures in docs workflow

Mon, 28 Sep 2026 23:27:36 GMT

By markmandel

When npm run lint fails, emit an error annotation pointing to npm run fix:tables (from tools/) for Markdown table formatting, and npm run lint:fix for ESLint issues.

Merged #8620: Note about proxy_url for attachments

Mon, 28 Sep 2026 22:30:51 GMT

By colinloretz

Refactor and closes https://github.com/discord/discord-api-docs/pull/5174

Merged #8623: Fix age-restricted command links

Fri, 25 Sep 2026 19:02:31 GMT

By biast12

Update application command documentation links to use the correct age-restricted-commands anchor.

Merged #8617: fix(snowflake): make diagram colors theme-aware for dark mode

Thu, 24 Sep 2026 20:54:09 GMT

By MadeByFulvo

Fixes #8614 The Snowflake to DateTime diagram on the API reference page hardcodes light-mode colors (fill="#252525" on text, fixed accent colors on the bit groups), which makes it unreadable when the…

Opened #8624: Document unique target fields on merged MEMBER_MOVE / MEMBER_DISCONNECT entries

Wed, 23 Sep 2026 15:52:20 GMT

By SzymonTyburczy. Labels: not released

Companion to discord/discord#304942 (internal). Merged MEMBER_MOVE / MEMBER_DISCONNECT audit log entries gain three fields in options: - unique_count: number of distinct users targeted within the mer…

Merged #8622: Age Assurance for devs changelog

Tue, 22 Sep 2026 18:26:58 GMT

By colinloretz

We recently announced the launch of age assurance. For most developers, nothing changes: existing apps, bots, games, Activities, and Social SDK integrations continue to work as is. There are four beh…

Merged #8621: Remove battlenet row from Connection Services table

Tue, 22 Sep 2026 16:53:45 GMT

By markmandel

Battle.net connections are removed on September 22, 2026

Merged #8610: Invite Add/Remove Single/Bulk User Endpoints

Mon, 21 Sep 2026 20:41:26 GMT

By anthonydiscord

Update Target Users replaces an invite's entire target user list from an uploaded CSV, which is processed as an asynchronous job. Changing a single user meant rebuilding and re-uploading the whole fi…

Merged #8612: DEFERRED_UPDATE_MESSAGE and UPDATE_MESSAGE can reply to MODAL_SUBMIT

Mon, 21 Sep 2026 20:17:07 GMT

By colinloretz

To update and close #5486

Opened #8571: Add Gateway Guild Tag

Tue, 01 Sep 2026 03:29:54 GMT

By Droid00000

I saw that GUILD_CREATE guilds have a profile field with some stuff about the guild's tag. Since gateway fields aren't in the spec and this field is used by the client, I thought it might be okay to…

Opened #8562: Document that text display components allows 4k characters

Wed, 26 Aug 2026 06:39:14 GMT

By Erk-

Draft #8538: Clarify accepted image-data formats (emoji also accepts WebP/AVIF)

Wed, 12 Aug 2026 15:07:34 GMT

By spenhand

The Image Data section in reference.mdx states the Data URI "supports JPG, GIF, and PNG formats" with no qualification. That contradicts the Emoji Formats section (emoji.mdx), which correctly lists J…