Developers
Upcoming API changes
Pull requests on discord/discord-api-docs, where Discord's developer docs live: the open ones and the most recently merged. A good way to spot docs for new features before they're announced. Keep in mind anyone can open a PR and plenty are wording fixes, so an open one isn't a promise. Dependency bumps are left out.
Open 33 3 of them drafts
Active this week 3 open PRs updated in 7 days
Merged in 30 days 21 last
Oldest open 3.3y #6285, opened Jul 10, 2023
Open
newest first Open Clarify voice clients should only select a protocol once per session #8708 · colinloretz · Add warning to Select Protocol example and add note to start a new session on 4006 Open Note that only app-owned webhooks can use app emojis #8705 · materwelonDhruv · updated · 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. Open Add clarity around interaction endpoint rate limits #8685 · 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… Open Remove obsolete node-fetch usages in favor of native Fetch API #8650 · DivyaRaval1909 · updated · 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… Open Document unique target fields on merged MEMBER_MOVE / MEMBER_DISCONNECT entries #8624 · SzymonTyburczy · updated · 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… not released Open Add Gateway Guild Tag #8571 · Droid00000 · updated · 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… Open Document that text display components allows 4k characters #8562 · Erk- · updated Draft Clarify accepted image-data formats (emoji also accepts WebP/AVIF) #8538 · 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… Open Documentation for Guild Join Requests, aka Server Member Applications #8531 · colinloretz · updated · Adding docs for Guild Join Request Endpoints: - List Guild Join Requests - Action Guild Join Request Guild Join Request Gateway events: - Guild Join Request Create - Guild Join Request Update - Guild… Draft Add rpc.video.write/read and rpc.screenshare.write/read scopes #8447 · OfficialSirH Open Scheduled Event Exceptions #8389 · Droid00000 · updated · See https://github.com/discord/discord-api-docs/pull/8069#issuecomment-4654559473. Closes #8009 Open improve emoji docs #8329 · AlmostSuspense · adds emoji name length requirements, consistently use plural and add description for more obscure fields like requires_colons (that support article needs updated visuals btw) Open Add Home Settings #8306 · Droid00000 · updated · I saw that this object was already in the API spec, but I couldn't find anything in the docs. Bots can only GET the home settings, but not PUT them Open Document User & Member display name styles #8178 · Soheab · updated · Title. Mostly copied from the unofficial docs. not released Open Be more consistent with showing enums in comments #8086 · RiskyMH · updated · originally trying to just fix https://discord.com/channels/613425648685547541/1130595287078015027/1462861572119466055, but then I realized not all codeblocks shows their possible enum edition Open Fix insecure HTTP links and resolve linting errors in tools #8043 · RZSISTEMAs · This commit updates several insecure http:// links to https:// across the documentation files for better security and standards compliance. It also fixes approximately 1700 linting errors in the tool… Open fix heartbeat jitter inconsistency #8027 · maukkis · This pr fixes the inconsistency with defining jitter as in the info box it was defined to be between 0 and heartbeat_interval Open docs: ✏️ Add embedded Field for Client Status Object #7996 · FabienBounoir · updated · Added documentation to cover the case of an undocumented embedded field in the Client Status object. Observed in payloads for some customers, although not mentioned in official documentation. This fi… Open Update resolved channel fields #7957 · Sacul0457 · updated · This PR updates what fields a resolved channel object has, or in this case what fields that are always missing. I added the '(always)' because certain channel types do not have a field that other cha… next-docs Open Add GUILD_PROFILE_UPDATE entry to audit log #7931 · MinnDevelopment · updated · Example: Open Add activity feed features #7903 · sebm253 · updated · accidentally closed the previous PR https://github.com/discord/discord-api-docs/pull/7129 Open Update Edit Message to reflect that not every parameter is nullable #7853 · onerandomusername · updated · These parameters are not all nullable. Draft Document invite profile #7849 · Soheab · updated · I noticed that the GET /invites/{code} endpoint has included a profile field for a while now, but it hasn’t been documented yet. This PR does exactly that. Additionally, there’s an endpoint not acces… Open Add missing nameplate asset CDN endpoints #7783 · ManHatos · updated · they are referenced in the nameplate docs but not actually documented since this is the only endpoint where the variable is actually a path and has a trailing /, i thought adding a + would be clearer Open Add example with localizations to Application Role Connection Metadata object #7713 · MZRCode · updated · Adds a simple multilingual example to show how metadata can support global users. Open Clarify session invalidation when reconnecting. #7571 · OoLunar · updated · Since the only section I could find documenting session invalidation behavior was in the disconnecting section, I figured reiterating the invalidation process would be more helpful here present than… gateway Open Add invite type to Invite Create event #7465 · TheKodeToad · updated · This does seem to be sent over the gateway but it's only documented for the REST API. gateway Open [Voice] Clarified documentation on how to disconnect #7444 · seailz · updated · I couldn't find this anywhere else in the docs, so I added information on how to complete a graceful disconnect from a voice channel to the Voice connections page. voice Open fix(interaction_metadata): document command_type #7383 · ImRodry · updated · This PR documents the command_type key that is sent on the interaction_metadata object of a Message. Not sure why this wasn't documented as the PR that added the object (#6723) did not have any discu… Open Clarify members included in Guild Create #7354 · advaith1 · updated · Currently, the documentation of which members are included in the Guild Create event is in the Request Guild Members section. This has led to a lot of confusion. This PR moves it to the Guild Create… gateway Open Clarify if sessions are resumable for each gateway close code #7172 · Zoddo · updated · This PR (which was made after this DDevs thread) attempts to clarify which gateway close codes are potentially resumable, and which ones are not worth trying to resume. The idea is that libs can imme… gateway Open Clarifying how sharding works #6853 · GitMeep · updated · I and at least one other user in this Forum Channel thread on the Discord Developers server were confused about how sharding worked with different num_shards for different sessions. I have rewritten… Open Add additional audit log key exceptions #6285 · A5rocks · updated · Spotted these while checking my transcription of the docs :D I'm not too sure of the "instead of" wording and there may be other exceptions like these. Nonetheless, I've spotted these so I documented…
Recently merged
by merge date Merged Flatten stylesheets for js snippets #8701 · colinloretz · opened Nov 2, 2026 · Mintlify is silently dropping nested styles Merged add IS_COMPONENTS_V2 as allowed flag for thread starting message #8444 · folospior · opened Jul 4, 2026 · 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 Removed redundant optional mark from flags and applied_tags fields #8421 · TakemiSora · opened Jun 19, 2026 · 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 Document role / member permission endpoints for guilds / channel #8695 · Lulalaby · opened Oct 29, 2026 · As requested by @anthonydiscord This also fixes the previous changelogs missing "developer resources" header Merged Delete message doesn't support audit log #8427 · RiskyMH · opened Jun 23, 2026 · 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 Document app role connection platform_username #8303 · advaith1 · opened Apr 16, 2026 · This was included in the PUT request body but not the response object. Merged Remove Content-Type note for webhook events #8470 · Xirado · opened Jul 17, 2026 · 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 Fix lint-staged for markdown files #8699 · colinloretz · opened Oct 30, 2026 Merged Update dependencies 10/30 #8698 · colinloretz · opened Oct 30, 2026 · - bump brace-expansion - add esbuild and fsevents to allowScripts - fix two broken links found in CI Merged Voice Channel Status Permission Clarification #8696 · colinloretz · opened Oct 29, 2026 · 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 Remove flags from Modify Guild Channel Positions #8692 · advaith1 · opened Oct 29, 2026 · This was a mistake in #8465, this endpoint does not take a flags field. Merged Channel and Role Position Update Audit Logs #8691 · advaith1 · opened Oct 29, 2026 · 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 Better document unavailable guilds #8690 · colinloretz · opened Oct 28, 2026 · 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 docs: document content-scanning flags for attachments and embeds #8687 · markmandel · opened Oct 26, 2026 · 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 fix: keep YouTube chapter dropdown above page content #8689 · markmandel · opened Oct 27, 2026 · 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 docs: embed Building Game Stats Widgets video on overview page #8686 · markmandel · opened Oct 26, 2026 · Included the chapter list, since it's a longer video. Merged docs: clarify invite flow for non-linked players #8682 · markmandel · opened Oct 20, 2026 · 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. social-sdk Merged docs: document SetTokenExpirationCallback for full Discord account tokens #8680 · markmandel · opened Oct 20, 2026 · 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… social-sdk Merged docs: document lobby membership change callbacks #8678 · markmandel · opened Oct 20, 2026 · 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… social-sdk Merged docs: document 180s game invite join window after cold launch #8669 · markmandel · opened Oct 15, 2026 · 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 OAuth now includes `iss` #8668 · anthonydiscord · opened Oct 14, 2026 · 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 docs: port remaining content from the SDK doxygen installation page #8659 · markmandel · opened Oct 9, 2026 · 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… social-sdk Merged docs: port remaining content from the SDK doxygen getting started page #8658 · markmandel · opened Oct 8, 2026 · 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… social-sdk Merged docs: port remaining content from the SDK doxygen authentication page #8649 · markmandel · opened Oct 6, 2026 · 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… social-sdk Merged Update name of getActivityInstanceConnectedParticipants #8651 · advaith1 · opened Oct 6, 2026 · 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 Document link previews #8606 · anthonydiscord · opened Sep 16, 2026 · 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 Fix Monospace component #8653 · anthonydiscord · opened Oct 6, 2026 · 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… Merged docs: note provisional accounts only receive DMs while in-game #8644 · markmandel · opened Oct 3, 2026 · 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… social-sdk Merged docs: document global vs per-call voice control override behavior #8643 · markmandel · opened Oct 2, 2026 · Global (Client-level) mute/deafen settings override per-call (Call- level) settings. social-sdk Merged Bug: Refresh the playlist carousel's cached video list #8641 · markmandel · opened Oct 1, 2026 · 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 docs: clarify lobby membership persists after SDK disconnect #8638 · markmandel · opened Sep 29, 2026 · 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 Add audit log permission to get ban endpoints #8634 · advaith1 · opened Sep 28, 2026 · VIEW_AUDIT_LOG gives permission to get bans, like the gateway events, but this was missing from the docs. fixes #8630 Merged Add video support to the docs and embed the Discord Developers catalog #8604 · markmandel · opened Sep 15, 2026 · 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 Document team member user as a full user object #8626 · kwy404 · opened Sep 24, 2026 · 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 Explain how to fix lint failures in docs workflow #8627 · markmandel · opened Sep 24, 2026 · 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 Note about proxy_url for attachments #8620 · colinloretz · opened Sep 21, 2026 · Refactor and closes https://github.com/discord/discord-api-docs/pull/5174 Merged Fix age-restricted command links #8623 · biast12 · opened Sep 23, 2026 · Update application command documentation links to use the correct age-restricted-commands anchor. Merged fix(snowflake): make diagram colors theme-aware for dark mode #8617 · MadeByFulvo · opened Sep 19, 2026 · 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… Merged Age Assurance for devs changelog #8622 · colinloretz · opened Sep 22, 2026 · 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 Remove battlenet row from Connection Services table #8621 · markmandel · opened Sep 21, 2026 · Battle.net connections are removed on September 22, 2026 Merged Invite Add/Remove Single/Bulk User Endpoints #8610 · anthonydiscord · opened Sep 18, 2026 · 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 DEFERRED_UPDATE_MESSAGE and UPDATE_MESSAGE can reply to MODAL_SUBMIT #8612 · colinloretz · opened Sep 18, 2026 · To update and close #5486
No pull requests match that. Try a word from the title, an author or a PR number.
From the GitHub API for discord/discord-api-docs; titles and descriptions are the authors' own. Merged API changes show up in the changelog when announced, and in the OpenAPI spec (discord/discord-api-spec) when the schema changes. Checked Nov 9, 16:51 UTC.