Developers
API changelog
Discord's own notes to developers: new endpoints, gateway changes, deprecations and anything that could break your bot. Mirrored from discord/discord-api-docs, newest first, with 60 entries going back to Feb 2026.
Last 90 days 22 announcements
Breaking changes 5 newest
Busiest topic Discord Social SDK 30 of 60 entries
October 20267
30 Oct New Endpoints for getting member and role permissions for guilds and channels You can now get a member or role's permissions for a guild or channel without calculating them yourself, using the new Get Guild Member Permissions, Get Guild Role Permissions, Get Channel Member Permissions, and Get Channel Role Permissions endpoints. HTTP API 29 Oct Voice Channel Status Permission Clarification Users connected to a voice channel can set its status with SET_VOICE_CHANNEL_STATUS even without CONNECT. HTTP APIDocumentation 29 Oct Channel and Role Position Update Audit Logs New audit log events for reordering channels and roles HTTP APIGateway 28 Oct Content Scanning Flags for Attachments, Embeds, and Media Attachments, embeds, and unfurled media items now document the flags Discord sets when its content scanning flags media as explicit, gore, or self-harm. HTTP APIComponents 14 Oct OAuth2 Authorization Responses Now Include iss OAuth2 redirects to your app now include an iss parameter identifying Discord as the authorization server. HTTP API 6 Oct getActivityInstanceConnectedParticipants Command Renamed The getInstanceConnectedParticipants command has been renamed to getActivityInstanceConnectedParticipants ActivitiesEmbedded App SDK 5 Oct Component Embeds and Link Preview Docs Websites can customize their Discord link preview with a component embed, and new Link Previews documentation covers the tags Discord reads from a page. ComponentsDocumentation
September 20269
28 Sep Videos in the Documentation Videos from the Discord Developers YouTube channel are now embedded throughout the docs, with chapter navigation and running times on long-form content. Docs 22 Sep Age Assurance: What It Means for Discord Developers Age assurance is rolling out globally. Apps continue to work as is, but you may observe changes to custom status visibility, age-restricted Activities, parent-set spending limits, and DM filtering. GatewayActivitiesPremium AppsDiscord Social SDK 18 Sep New Invite Target User Endpoints and Options New endpoints and options to create, add, and remove individual or multiple target users on an invite without using a CSV. HTTP API 17 Sep Custom Status Hidden by Profile Privacy Settings The custom status activity is omitted from Presence Update events dispatched to a guild based on the presence author's profile privacy setting. Gateway 17 Sep Unlinking Accounts Guide New guide covering best practices for unlinking a user's Discord account, including when to revoke tokens and how to avoid relink conflicts. Discord Social SDKHTTP API 15 Sep Shard Param Required for Get Current User Guilds with Large Bot Sharding Apps using large bot sharding must pass the shard query param to Get Current User Guilds. Breaking HTTP API 11 Sep Slash Command Improvements and Mobile Fixes String options now support multiline input, command autocomplete supports fuzzy search, and the input remembers your selected command when switching channels. Also fixes several mobile command experience bugs. Interactions 3 Sep Default File Upload Limit Increase The default file upload limit has been increased from 10 MiB to 20 MiB. HTTP APIInteractions 1 Sep Discord Social SDK Release 1.10.19337 Read-only access to the Discord desktop client's voice settings — mute/deafen, volumes, voice mode, and push-to-talk key — over RPC. Discord Social SDK
August 20269
27 Aug PRUNE_REQUIRES_ADMIN Guild Feature Prune endpoints require the ADMINISTRATOR permission if the guild has the new PRUNE_REQUIRES_ADMIN guild feature. Breaking HTTP API 26 Aug Game Stats Widgets Claimed games can now display player stats like rank, playtime, and wins on Discord user profiles using the new Application Identity Profile API. Discord Social SDKHTTP API 26 Aug Account Linking on Web New documentation for building account linking with the standard OAuth2 web flow, and updated guidance for enabling Discord entry points. Discord Social SDK 14 Aug Deprecation: Battle.net Connections in Get Current User Connections Battle.net connections are deprecated and will no longer be returned by the /users/@me/connections endpoint starting September 22, 2026. Breaking HTTP API 13 Aug Discord Social SDK 1.10.18687 Fixed the iOS web-authentication session clobbering the host app's ASWebAuthenticationSession presentation-context delegate during the OAuth flow. Discord Social SDK 12 Aug Channel Obfuscation for Users and Bots Users will stop receiving full metadata for channels they can't view. Gateway channels are redacted, and GET /guilds/{guild.id}/channels omits them. This becomes mandatory for all bots on November 16, 2026. Breaking GatewayHTTP API 11 Aug Discord Social SDK Hotfixes 1.10.18369, 1.9.18337 & 1.8.18335 Hotfix releases across the 1.8, 1.9, and 1.10 branches fixing C# bool marshaling and a PlayStation 5 lobby dispatch crash. Discord Social SDK 5 Aug Filter File Types in File Uploads and Attachment Options File Upload components and ATTACHMENT command options now accept a file_types array that restricts which files a user can upload. InteractionsComponents 5 Aug Channel application_id is Now Nullable The application_id field on the channel object is now documented as nullable, and will be serialized as null in some cases. Breaking HTTP API
July 20264
28 Jul Discord Social SDK 1.10.18247 New minimum SDK versions for Xbox and PlayStation 5, Rich Presence over RPC on Android, a repackaged macOS framework, WebRTC M130, and a batch of stability fixes. Discord Social SDK 22 Jul Provisional Accounts Documentation Restructure The Using Provisional Accounts guide has been split into a dedicated Provisional Accounts section, with a focused page for each authentication, merge, and unmerge flow. Discord Social SDK 16 Jul Resolved Channel app_permissions in Interactions Resolved channels in interactions now include the app_permissions field. Interactions 7 Jul Deprecation: Riot Games Connections in Get Current User Connections Riot Games and League of Legends connections are no longer returned by the /users/@me/connections endpoint as part of their migration to the Discord Social SDK. HTTP APIDiscord Social SDK
June 20267
30 Jun Discord Social SDK 1.9.17379 Fixed a PlayStation 5 crash caused by re-entrant HTTP requests during connection teardown. Discord Social SDK 25 Jun Discord Social SDK 1.9.17228 Fixed an AUTHORIZE_REQUEST re-subscription issue and bundled Krisp noise suppression into the Unity and Unreal plugin packages. Discord Social SDK 24 Jun Attachment Editing and is_spoiler Param Some attachment metadata can now be edited, and the is_spoiler parameter should be used for setting spoiler status. HTTP API 16 Jun Documentation Fix: Subscription Status Values Corrected the integer values for the INACTIVE and ENDING subscription statuses, which were swapped in the Subscription reference and the Implementing App Subscriptions guide. HTTP API 10 Jun Changes to Privileged Intent Access for Discord Apps Changes to the review threshold for privileged intent access, an annual reapplication process for continued access, and the ability for apps to keep growing during review. HTTP APIGateway 3 Jun Discord Social SDK 1.9.16441 Fixed a PlayStation 5 crash caused by a use-after-free in WebSocket callbacks. Discord Social SDK 3 Jun New Lobby HTTP API Endpoints Reference documentation added for create-or-join, send/get messages, and linked-channel invite endpoints on the Lobby resource. Discord Social SDKHTTP API
May 20265
26 May Discord Social SDK Release Cadence & Support New release cadence and support lifecycle taking effect with the 1.10 release in July 2026: a 5-version support window (1.6–1.10), and a rolling 18-month console OS SDK window where new Xbox and PlayStation SDKs ship only in new Social SDK releases. Discord Social SDK 22 May Account Linking Failure-Mode Documentation New documentation covering what happens when a Discord account is banned, when OAuth2 tokens are revoked, and how to design account linking for resilience. Discord Social SDK 12 May Discord Social SDK 1.9.15780 Xbox GDK 260400 support and Krisp noise suppression integration across Android, iOS, macOS, and Windows. Discord Social SDK 7 May New flags_new Field on Application Object The Application object now includes a `flags_new` field, a string-serialized integer containing all application flag bits including those beyond 32-bit precision. HTTP API 5 May User Premium Type Field Now Requires A Scope The `premium_type` field on the User object now requires the `identify.premium` scope to return a user's Nitro subscription level. HTTP API
April 20269
24 Apr Voice Muting Based on Player Blocks Guide New how-to guide for implementing bi-directional voice muting in lobby voice calls based on block relationships, with client-side and server-side approaches. Discord Social SDKHTTP API 23 Apr Discord Social SDK 1.9.15332 PlayStation 5 OS 13.000 support and activity invite fix for Publisher Level Account Linking. Discord Social SDK 23 Apr Proximity Voice Chat Guide for Game Developers New guide on how to intercept Discord Social SDK voice audio and route it to Unity's 3D audio system to build proximity voice chat for multiplayer games. Discord Social SDK 22 Apr Security Updates for Provisional Account OIDC Integrations Recent security improvements to provisional account OIDC issuer validation are now documented. Existing integrations are unaffected, but review the new requirements before editing your configuration. Discord Social SDK 20 Apr Voice Channel Status and Start Time Documentation Documentation for Set Voice Channel Status endpoint, permission, and related Gateway and audit log events. Documentation 16 Apr Deprecation: OAuth2 Refresh Token Grant for OIDC Provisional Accounts Using the OAuth2 refresh_token grant to refresh OIDC server-side provisional account tokens is deprecated. Re-authenticate using a fresh provider token instead. Discord Social SDK 14 Apr Message Forwarding Requires Message Content Access Starting today, applications must be able to read a message's content in order to forward it. HTTP API 6 Apr Discord Social SDK 1.8.14985 Xbox GDK 251002 support. Discord Social SDK 3 Apr RPC over IPC Documentation Documentation for RPC over IPC transport is now available, covering connection, opcodes, and IPC-specific events. RPC
March 20268
27 Mar Discord Social SDK 1.8.14856 Debug plugins for iOS Unity & Unreal, and fix for party privacy settings not propagating. Discord Social SDK 19 Mar Search Guild Messages Endpoint Search Guild Messages endpoint allows bots to search for messages within a guild using various filters and sorting options HTTP API 15 Mar Discord Social SDK 1.8.14587 Debug library support for Unity, Unreal, Windows, Mac, Linux, Android, PS5, PS4, and Xbox. Discord Social SDK 9 Mar Developer Portal & Docs Refresh New home page, UI redesign, new developer guides, and improved docs navigation. Docs 5 Mar Discord Social SDK 1.8.14437 Bearer token filtering, log level changes, debug warning. Discord Social SDK 5 Mar Discord Social SDK 1.7.14433 Bearer token filtering, log level changes, debug warning. Discord Social SDK 5 Mar Discord Social SDK 1.6.14448 Bearer token filtering, log level changes, debug warning. Discord Social SDK 3 Mar Updates to Context Menu Commands New UI for User Commands and Message Commands with increased limits and improved organization Interactions
February 20262
20 Feb Server-Side Message Moderation New API endpoints for modifying moderation metadata on game direct messages and lobby messages Discord Social SDKHTTP APIDocs 19 Feb Discord Social SDK Release 1.8.14026 Fixed an occasional crash when linking Discord account while in a Voice Call Discord Social SDK
Nothing in the changelog matches that. Try another word, or pick a different topic.