├── .gitattributes ├── .github ├── CODEOWNERS ├── ISSUE_TEMPLATE │ ├── api-bug-report.yml │ ├── app-subscriptions-bug-report.yml │ ├── config.yml │ ├── developer-site-bug-report.yml │ ├── message-components-bug-report.yml │ └── slash-command-bug-report.yml ├── dependabot.yml └── workflows │ ├── docs.yaml │ └── test.yaml ├── .gitignore ├── .prettierignore ├── .prettierrc.json ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE ├── LICENSE-CODE ├── README.md ├── docs ├── activities │ ├── building-an-activity.mdx │ ├── design-patterns.mdx │ ├── development-guides.mdx │ ├── development-guides │ │ ├── assets-and-metadata.mdx │ │ ├── growth-and-referrals.mdx │ │ ├── layout.mdx │ │ ├── local-development.mdx │ │ ├── mobile.mdx │ │ ├── multiplayer-experience.mdx │ │ ├── networking.mdx │ │ ├── production-readiness.mdx │ │ └── user-actions.mdx │ ├── how-activities-work.md │ └── overview.mdx ├── change-log.mdx ├── change-log │ ├── 2017-07-19-breaking-change-version-6.md │ ├── 2017-07-24-new-feature-audit-logs.md │ ├── 2017-08-03-breaking-change-default-channels.md │ ├── 2017-08-16-breaking-change-presence-activity-objects.md │ ├── 2017-09-10-new-feature-emoji-endpoints.md │ ├── 2017-09-20-new-feature-channel-categories.md │ ├── 2017-10-16-breaking-change-api-gateway-below-v6-discontinued.md │ ├── 2017-11-09-new-feature-rich-presence.md │ ├── 2018-01-03-semi-breaking-change-very-large-bot-sharding.md │ ├── 2018-01-23-deprecation-accept-invite-endpoint.md │ ├── 2018-01-30-enhancement-get-guild-emoji-endpoint.md │ ├── 2018-02-05-enhancement-new-message-properties.md │ ├── 2018-06-11-deprecation-rpc-online-member-count-and-members-list.md │ ├── 2018-06-19-documentation-fix-list-of-open-dms-in-certain-payloads.md │ ├── 2018-11-30-enhancement-user-object.md │ ├── 2018-12-11-documentation-dispatch-store-listings.md │ ├── 2019-01-14-ask-to-join-rich-presence-sdk.md │ ├── 2019-04-18-new-invite-object-fields.md │ ├── 2019-04-29-deprecation-of-discord-rpc-rich-presence-sdk.md │ ├── 2019-05-29-added-info-around-nitro-boosting-experiment.md │ ├── 2019-06-19-additional-team-information.md │ ├── 2019-07-18-bot-tokens-for-achievements.md │ ├── 2019-08-12-more-precise-rate-limits.md │ ├── 2019-08-22-changes-to-special-channels.md │ ├── 2019-11-14-gamesdk-version-2.5.5.md │ ├── 2019-11-27-gamesdk-version-2.5.6.md │ ├── 2019-12-06-ip-discovery-updates.md │ ├── 2020-02-14-gateway-intents.md │ ├── 2020-02-26-rich-presence-spectate-approval.md │ ├── 2020-03-02-new-invite-events-and-reactions-endpoint.md │ ├── 2020-03-03-new-allowed-mentions-object.md │ ├── 2020-04-24-new-properties-on-guild-members-chunk-event.md │ ├── 2020-05-11-legacy-mention-behavior-deprecation.md │ ├── 2020-07-28-new-permission-fields.md │ ├── 2020-09-24-api-and-gateway-v8.md │ ├── 2020-10-27-gateway-v6-intent-restrictions.md │ ├── 2020-11-13-stickers.md │ ├── 2020-11-16-inline-replies.md │ ├── 2020-12-15-slash-commands-and-interactions.md │ ├── 2021-01-22-change-to-permission-checking-when-creating-channels.md │ ├── 2021-02-09-slash-commands-in-dms.md │ ├── 2021-03-05-changes-to-slash-command-response-types-and-flags.md │ ├── 2021-03-15-large-bot-sharding-lowered-to-150-000-guilds.md │ ├── 2021-04-05-application-command-permissions.md │ ├── 2021-04-28-api-v9.md │ ├── 2021-05-26-buttons-and-message-components.md │ ├── 2021-06-10-support-for-multiple-embeds-in-message-routes.md │ ├── 2021-06-30-select-menu-components.md │ ├── 2021-08-10-user-and-message-commands.md │ ├── 2021-09-16-updated-thread-permissions.md │ ├── 2021-10-27-application-command-autocomplete-interactions.md │ ├── 2021-11-23-guild-scheduled-events.md │ ├── 2021-12-20-guild-member-timeouts.md │ ├── 2022-02-08-interaction-modals-and-application-command-attachment-option-type.md │ ├── 2022-02-14-api-v10.md │ ├── 2022-03-31-guild-bans-pagination.md │ ├── 2022-04-06-forum-channels.md │ ├── 2022-04-27-updated-command-permissions.md │ ├── 2022-06-16-auto-moderation.md │ ├── 2022-06-17-updated-connection-property-field-names.md │ ├── 2022-06-21-message-content-in-auto-moderation-events.md │ ├── 2022-06-29-calculated-permissions-in-interaction-payloads.md │ ├── 2022-06-29-changes-to-bot-permissions-for-interactions-and-webhooks.md │ ├── 2022-07-01-add-subcommand-groups-and-subcommands-to-message-interaction-objects.md │ ├── 2022-07-01-min-and-max-length-for-command-options.md │ ├── 2022-07-13-upcoming-permissions-change-to-webhook-routes.md │ ├── 2022-08-09-session-specific-gateway-resume-urls.md │ ├── 2022-08-22-slash-command-mentions.md │ ├── 2022-09-01-message-content-is-a-privileged-intent.md │ ├── 2022-09-14-forum-channels-release.md │ ├── 2022-09-21-auto-moderation-spam-and-mention-spam-trigger-types.md │ ├── 2022-09-22-default-sort-order-for-forum-channels.md │ ├── 2022-10-13-new-select-menu-components.md │ ├── 2022-10-20-delete-ephemeral-messages.md │ ├── 2022-11-04-add-auto-moderation-regex-support.md │ ├── 2022-11-09-gamesdk-feature-deprecation.md │ ├── 2022-11-17-upcoming-application-command-permission-changes.md │ ├── 2022-11-22-add-auto-moderation-allow-list-for-keyword-rules-and-increase-max-keyword-rules-per-guild-limit.md │ ├── 2022-12-12-add-application-connections-metadata-and-linked-roles.md │ ├── 2022-12-13-add-default-layout-setting-for-forum-channels.md │ ├── 2023-01-09-thread-member-details-and-pagination.md │ ├── 2023-01-18-guild-audit-log-events.md │ ├── 2023-02-08-increase-auto-moderation-keyword-limits.md │ ├── 2023-02-10-update-to-locked-threads.md │ ├── 2023-02-24-add-auto-moderation-custom-message-action-metadata-field.md │ ├── 2023-04-06-interaction-channel-data.md │ ├── 2023-04-14-bot-users-added-to-all-new-apps.md │ ├── 2023-05-03-unique-usernames-on-discord.md │ ├── 2023-05-05-add-join-raid-and-mention-raid-fields.md │ ├── 2023-08-01-new-guild-media-channel-type.md │ ├── 2023-08-02-public-preview-of-openapi-3.1-specification.md │ ├── 2023-08-08-activity-state-for-bot-users.md │ ├── 2023-08-10-embed-debugger.md │ ├── 2023-08-23-team-member-roles.md │ ├── 2023-09-22-default-value-in-auto-populated-select-menus.md │ ├── 2023-09-26-premium-app-subscriptions-available-in-the-us.md │ ├── 2023-10-17-global-rate-limit-added-to-discord.com.md │ ├── 2023-10-19-premium-app-subscriptions-now-available-in-the-eu-and-uk.md │ ├── 2023-11-01-fix-message-edit-interaction-response-permissions.md │ ├── 2023-11-29-premium-app-subscriptions-new-ways-for-testing-app-subscriptions.md │ ├── 2023-12-01-experimenting-with-end-to-end-encryption-for-voice-video.md │ ├── 2023-12-15-clarification-on-permission-splits-for-expressions-and-events.md │ ├── 2023-12-19-limit-number-of-fields-in-embeds.md │ ├── 2024-00-20-soundboard-api.md │ ├── 2024-02-12-enforced-nonces-on-create-message-endpoint.md │ ├── 2024-03-15-guild-prune-requiring.md │ ├── 2024-03-18-discord-activities-developer-preview-of-the-embedded-app-sdk.md │ ├── 2024-03-18-user-installable-apps-preview.md │ ├── 2024-04-02-csv-export-for-premium-app-analytics.md │ ├── 2024-04-23-modify-guild-member-flags-field-permissions.md │ ├── 2024-04-24-premium-apps-one-time-purchases-and-store.md │ ├── 2024-05-31-auto-moderation-member-profile-rule.md │ ├── 2024-06-17-premium-apps-new-premium-button-style-deep-linking-url-schemes.md │ ├── 2024-06-27-user-installed-apps-general-availability.md │ ├── 2024-07-09-banners-in-get-current-user-guilds.md │ ├── 2024-07-15-message-forwarding-rollout.md │ ├── 2024-07-16-member-banners.md │ ├── 2024-07-17-activities-proxy-csp-update.md │ ├── 2024-07-18-application-emoji.md │ ├── 2024-07-25-supported-activity-types-for-set-activity.md │ ├── 2024-08-05-voice-state-endpoints.md │ ├── 2024-08-09-user-app-install-count.md │ ├── 2024-08-12-get-guild-role-endpoint.md │ ├── 2024-08-13-voice-encryption-modes.md │ ├── 2024-08-13-voice-gateway-version-8-and-deprecation-of-versions-older-than-4.md │ ├── 2024-08-26-entry-point-commands.md │ ├── 2024-08-26-launching-activities-via-interactions.md │ ├── 2024-08-28-subscription-api-and-entitlement-migration.md │ ├── 2024-09-04-add-polls-when-editing-deferred-interaction-responses.md │ ├── 2024-09-17-voice-e2ee-dave-protocol.md │ ├── 2024-09-26-activities-general-availability.md │ ├── 2024-10-04-updates-to-entitlement-migration-guide.md │ ├── 2024-10-25-event-webhooks.md │ ├── 2024-11-05-post-entitlement-migration-update.md │ ├── 2024-12-12-premium-apps-multiple-subscription-tiers.md │ ├── 2024-12-17-updated-file-upload-limit.md │ ├── 2025-03-17-introducing-the-discord-social-sdk.md │ ├── 2025-04-03-per-attachment-file-upload-limit.md │ ├── 2025-04-11-incentivized-links.md │ ├── 2025-04-15-deprecating-guild-createion-by-apps.md │ ├── 2025-04-16-discord-social-sdk-1.1.md │ ├── 2025-04-21-discord-social-sdk-1.1.8318.md │ ├── 2025-04-22-components-v2.md │ ├── 2025-04-29-component-limits.md │ ├── 2025-05-05-discord-social-sdk-1.2.md │ └── 2025-06-05-discord-social-sdk-1.3.md ├── components │ ├── overview.mdx │ ├── reference.mdx │ ├── using-message-components.mdx │ └── using-modal-components.mdx ├── developer-tools │ ├── community-resources.mdx │ ├── embedded-app-sdk.mdx │ └── game-sdk.mdx ├── discord-social-sdk │ ├── core-concepts.mdx │ ├── design-guidelines.mdx │ ├── design-guidelines │ │ ├── branding-guidelines.mdx │ │ ├── connection-points.mdx │ │ ├── consoles.mdx │ │ ├── direct-messages.mdx │ │ ├── game-friends.mdx │ │ ├── linked-channels.mdx │ │ ├── principles.mdx │ │ ├── provisional-accounts.mdx │ │ ├── signing-in.mdx │ │ ├── social-settings.mdx │ │ ├── status-rich-presence.mdx │ │ └── unified-friends-list.mdx │ ├── development-guides.mdx │ ├── development-guides │ │ ├── account-linking-on-consoles.mdx │ │ ├── account-linking-with-discord.mdx │ │ ├── creating-a-unified-friends-list.mdx │ │ ├── debugging-logging.mdx │ │ ├── integrating-moderation.mdx │ │ ├── joining-voice-chat.mdx │ │ ├── linked-channels.mdx │ │ ├── managing-game-invites.mdx │ │ ├── managing-lobbies.mdx │ │ ├── managing-relationships.mdx │ │ ├── sending-direct-messages.mdx │ │ ├── setting-rich-presence.mdx │ │ ├── using-provisional-accounts.mdx │ │ └── using-with-discord-apis.mdx │ ├── getting-started.mdx │ ├── getting-started │ │ ├── partials │ │ │ ├── dylib-mac-error.mdx │ │ │ └── getting-started.mdx │ │ ├── using-c++.mdx │ │ ├── using-unity.mdx │ │ └── using-unreal-engine.mdx │ ├── overview.mdx │ ├── partials │ │ └── callouts │ │ │ ├── console-access.mdx │ │ │ ├── limited-access.mdx │ │ │ ├── public-client.mdx │ │ │ └── support.mdx │ └── social-sdk-reference.mdx ├── discovery │ ├── best-practices.md │ ├── enabling-discovery.mdx │ └── overview.mdx ├── events │ ├── gateway-events.mdx │ ├── gateway.mdx │ ├── overview.mdx │ └── webhook-events.mdx ├── interactions │ ├── application-commands.mdx │ ├── overview.mdx │ └── receiving-and-responding.mdx ├── intro.mdx ├── monetization │ ├── enabling-monetization.mdx │ ├── implementing-app-subscriptions.mdx │ ├── implementing-iap-for-activities.mdx │ ├── implementing-one-time-purchases.md │ ├── managing-skus.mdx │ └── overview.mdx ├── policies-and-agreements │ ├── developer-policy.md │ ├── developer-terms-of-service.md │ └── store-distribution-agreement.md ├── quick-start │ ├── getting-started.mdx │ └── overview-of-apps.mdx ├── reference.mdx ├── resources │ ├── application-role-connection-metadata.mdx │ ├── application.mdx │ ├── audit-log.mdx │ ├── auto-moderation.mdx │ ├── channel.mdx │ ├── emoji.mdx │ ├── entitlement.mdx │ ├── guild-scheduled-event.mdx │ ├── guild-template.mdx │ ├── guild.mdx │ ├── invite.mdx │ ├── lobby.mdx │ ├── message.mdx │ ├── poll.mdx │ ├── sku.mdx │ ├── soundboard.mdx │ ├── stage-instance.mdx │ ├── sticker.mdx │ ├── subscription.mdx │ ├── user.mdx │ ├── voice.mdx │ └── webhook.mdx ├── rich-presence │ ├── best-practices.md │ ├── overview.mdx │ ├── using-with-the-discord-social-sdk.mdx │ ├── using-with-the-embedded-app-sdk.mdx │ └── using-with-the-game-sdk.mdx ├── topics │ ├── certified-devices.md │ ├── oauth2.mdx │ ├── opcodes-and-status-codes.md │ ├── permissions.md │ ├── rate-limits.md │ ├── rpc.md │ ├── teams.md │ ├── threads.md │ └── voice-connections.mdx └── tutorials │ ├── configuring-app-metadata-for-linked-roles.md │ ├── developing-a-user-installable-app.mdx │ ├── hosting-on-cloudflare-workers.md │ └── upgrading-to-application-commands.md ├── eslint.config.js ├── index.js ├── package-lock.json ├── package.json ├── resources └── discord-social-sdk │ └── linked-channel-icon.svg ├── static └── images │ ├── API_center.gif │ ├── activities-presence-example.png │ ├── activities │ ├── activities-hero.png │ ├── activity-instance-validation.jpg │ ├── application-test-mode-prod.gif │ ├── bobble-bash.png │ ├── bobble-league.png │ ├── chess-victory.png │ ├── custom-link-embed.png │ ├── debug-logs-filtering.gif │ ├── default_orientation_lock_state.png │ ├── developer-mode.gif │ ├── discord-activities.png │ ├── eights.png │ ├── embedded-app-flow-diagram.svg │ ├── enable-activities.png │ ├── encourage-hardware-acceleration-modal.png │ ├── external-link-modal.png │ ├── invite-dialog.png │ ├── join-application.png │ ├── new-app.png │ ├── oauth-flow-diagram.svg │ ├── oauth2-details.png │ ├── oauth2-redirect.png │ ├── share-moment-dialog-example.png │ ├── start-activity.png │ ├── supported-platforms.png │ ├── tutorial-auth.png │ ├── tutorial-channel-name.png │ ├── tutorial-hero.png │ ├── tutorial-launched.png │ ├── url-mapping-do.png │ ├── url-mapping-dont.png │ └── url-mapping-tutorial.png │ ├── alerts.png │ ├── annotated-presence-data-activities.png │ ├── app-add-bot.png │ ├── app-create-modal.png │ ├── ask-to-join.gif │ ├── available-published.png │ ├── botuser-profile.png │ ├── bp-productpage-app-description.png │ ├── bp-productpage-summary-bad.png │ ├── bp-productpage-summary-good.png │ ├── bp-productpage-tags.png │ ├── button-styles.png │ ├── certified-device.png │ ├── cloudflare-general-overview.png │ ├── cloudflare-interactions-endpoint.png │ ├── cloudflare-ngrok.png │ ├── cloudflare-tutorial-demo.gif │ ├── cloudflare-url-generator.png │ ├── command-entry-point.png │ ├── command-types.png │ ├── command-with-groups-subcommands-parameters.png │ ├── command-with-groups-subcommands.png │ ├── command.png │ ├── components │ ├── action-row.png │ ├── channel-select.png │ ├── container.png │ ├── file.png │ ├── hero.png │ ├── media-gallery.png │ ├── mentionable-select.png │ ├── modal.png │ ├── role-select.png │ ├── section.png │ ├── separator.png │ ├── string-select.png │ ├── text-display.png │ └── user-select.png │ ├── cpp-files-sdk.png │ ├── create-store-channel.png │ ├── create-team-owned-app.png │ ├── default-presence-activities.png │ ├── deferred-example.png │ ├── desktop-role-select-menu.png │ ├── desktop-select.png │ ├── discovery-app-directory-product-page.png │ ├── discovery-app-launcher.png │ ├── discovery-sharing-links.png │ ├── docs-header.svg │ ├── example-poll.png │ ├── examples-ephemeral-message.png │ ├── examples-message-reactive.png │ ├── examples-update-message.png │ ├── game-overlay-sdk-invite.gif │ ├── game-overlay-sdk-voice-settings.png │ ├── game-overlay-sdk-voice-widget.png │ ├── game-sdk-presence-example.png │ ├── gateway-lifecycle.svg │ ├── getting-started-default-install.png │ ├── getting-started-demo.gif │ ├── getting-started-interactions-endpoint.png │ ├── gift-code-creation.png │ ├── glitch-project.png │ ├── heroku-baking.gif │ ├── heroku-buildpack.png │ ├── heroku-configVars.png │ ├── heroku-connectGH.png │ ├── heroku-deploy.png │ ├── heroku-dynos.png │ ├── heroku-login.png │ ├── heroku-logs.png │ ├── heroku-procfile.png │ ├── heroku-token.png │ ├── interactions-url.png │ ├── lib-linked-sdk.png │ ├── linked-roles-connect-account.png │ ├── linked-roles-connected.png │ ├── linked-roles-consent-dialog.png │ ├── linked-roles-glitch-share-url.png │ ├── linked-roles-glitch.png │ ├── linked-roles-oauth-config.png │ ├── linked-roles-register.png │ ├── linked-roles-verification-setup.png │ ├── linked-roles-verify-endpoint.png │ ├── mdx-button.png │ ├── mdx-card.png │ ├── mdx-collapsible.png │ ├── message-command.png │ ├── mobile-select.png │ ├── modal-desktop.png │ ├── monetization-eligibility.png │ ├── monetization-interaction-response.png │ ├── monetization-overview.png │ ├── monetization.png │ ├── multiple-buttons-example-1.png │ ├── multiple-buttons-example-2.png │ ├── multisub.png │ ├── new-permissions-flowchart.svg │ ├── overview-command-desktop.png │ ├── overview-components.png │ ├── overview-modals.png │ ├── overview-of-apps-banner.png │ ├── premium-button.png │ ├── premium-example.png │ ├── premium-items.png │ ├── premium-subscriptions.png │ ├── previous-new-server-background.png │ ├── rich-presence-asset-images.png │ ├── rich-presence-examples.png │ ├── rich-presence-invite-image.png │ ├── rp-actionable.png │ ├── rp-all-fields.png │ ├── rp-good-art.png │ ├── rp-legend.png │ ├── rp-profile-example-1.png │ ├── rp-profile-example-2.png │ ├── rp-short-strings.png │ ├── server-banner-example.png │ ├── server-banner-margin-top.png │ ├── sku-benefits.png │ ├── sku-configure.png │ ├── sku-custom.png │ ├── sku-customization.png │ ├── sku-management.png │ ├── sku-publish.png │ ├── sku-unicode.png │ ├── sku_embed.png │ ├── slash-command-options.png │ ├── snowflake.png │ ├── snowflake_original_size.png │ ├── social-sdk │ ├── design-guidelines │ │ ├── Brand-02.png │ │ ├── Brand-03.png │ │ ├── Brand-04.png │ │ ├── ConnectionPoints-02.png │ │ ├── ConnectionPoints-03.png │ │ ├── ConnectionPoints-04.png │ │ ├── ConnectionPoints-05.png │ │ ├── Consoles-01.jpg │ │ ├── Consoles-02.jpg │ │ ├── Consoles-03.jpg │ │ ├── Consoles-04.jpg │ │ ├── Consoles-05.jpg │ │ ├── Consoles-06.jpg │ │ ├── DMs-02.png │ │ ├── DMs-03.png │ │ ├── DMs-04.png │ │ ├── GameFriends-01.png │ │ ├── GameFriends-02.png │ │ ├── GameFriends-03.png │ │ ├── GameFriends-04.png │ │ ├── GameFriends-05.png │ │ ├── GameFriends-06.png │ │ ├── GameFriends-07.png │ │ ├── GameFriends-08.png │ │ ├── GameFriends-09.png │ │ ├── GameFriends-10.png │ │ ├── LinkedChannels-04.png │ │ ├── LinkedChannels-05.png │ │ ├── LinkedChannels-06.png │ │ ├── LinkedChannels-07.png │ │ ├── Principle-02.png │ │ ├── Principle-03.png │ │ ├── Principle-04.png │ │ ├── Principle-05.png │ │ ├── Principle-06.png │ │ ├── Principle-07.png │ │ ├── Prov-02.png │ │ ├── Prov-03.png │ │ ├── Prov-04.png │ │ ├── Prov-05.png │ │ ├── SigningIn-02.png │ │ ├── SigningIn-03.png │ │ ├── SigningIn-04.png │ │ ├── SigningIn-05.png │ │ ├── SigningIn-06.png │ │ ├── SigningIn-07.png │ │ ├── SigningIn-08.png │ │ ├── SocialSettings-02.webp │ │ ├── SocialSettings-03.webp │ │ ├── SocialSettings-04.webp │ │ ├── StatusPresence-02.png │ │ ├── StatusPresence-03.png │ │ ├── StatusPresence-04.png │ │ ├── StatusPresence-05.png │ │ ├── StatusPresence-06.png │ │ ├── UFL-02.png │ │ ├── UFL-03.png │ │ ├── UFL-04.png │ │ ├── UFL-05.png │ │ ├── UFL-06.png │ │ ├── UFL-07.png │ │ ├── UFL-08.png │ │ └── animated │ │ │ ├── Connecting-via-Browser.gif │ │ │ ├── Connecting-via-Client.gif │ │ │ ├── DMs-02.gif │ │ │ ├── LinkedChannel-Setup.gif │ │ │ ├── LinkedChannel-Unlink.gif │ │ │ ├── LinkedChannels-02.gif │ │ │ ├── LinkedChannels-08.gif │ │ │ └── UFL-06.gif │ ├── development-guides │ │ ├── authorize_device.png │ │ └── discord-game-dm-settings.png │ ├── getting-started │ │ └── partials │ │ │ ├── error.png │ │ │ ├── open-anyway.png │ │ │ └── settings-security.png │ ├── integrating-moderation │ │ ├── message-receiving.svg │ │ ├── message-sending.svg │ │ └── platform-bans.svg │ └── overview │ │ └── social_sdk_header.png │ ├── spectate.gif │ ├── store_embed.png │ ├── team-page.png │ ├── transfer-app-to-team.png │ ├── url-generator.png │ ├── user-command.png │ ├── user-install-game-message.png │ └── user-install-settings.png ├── tools ├── checkBuild.ts ├── checkLinks.ts ├── doxygen │ ├── decorate-social-sdk-references.js │ ├── generate-social-sdk-mapping.js │ └── social-sdk-mappings.json ├── parse-changelog.js └── rename-files.js └── tsconfig.json /.gitattributes: -------------------------------------------------------------------------------- 1 | # automatically normalize line endings 2 | * text=auto 3 | 4 | .git* text 5 | *.json text 6 | *.js text 7 | *.md text linguist-detectable 8 | *.{yml,yaml} text 9 | 10 | *.png binary 11 | *.{jpeg,jpg} binary 12 | -------------------------------------------------------------------------------- /.github/CODEOWNERS: -------------------------------------------------------------------------------- 1 | * @discord/devrel 2 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/api-bug-report.yml: -------------------------------------------------------------------------------- 1 | name: API Bug Report 2 | description: A bug has been found in Discord's API, Gateway, OAuth2, SDK, etc. 3 | labels: ["bug"] 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: "Before opening a new issue, please search existing issues: https://github.com/discord/discord-api-docs/issues" 8 | - type: textarea 9 | id: description 10 | attributes: 11 | label: Description 12 | description: Provide a clear and concise description of what the problem is. 13 | validations: 14 | required: true 15 | - type: textarea 16 | id: steps 17 | attributes: 18 | label: Steps to Reproduce 19 | description: Include specific cURL requests that we can copy and paste to replicate your issue. Provide specific, clear, and concise steps for us to reliably reproduce this issue. 20 | validations: 21 | required: true 22 | - type: textarea 23 | id: expected 24 | attributes: 25 | label: Expected Behavior 26 | description: What is the behavior you expect to occur that is not? 27 | validations: 28 | required: true 29 | - type: textarea 30 | id: current 31 | attributes: 32 | label: Current Behavior 33 | description: What is the behavior you are currently seeing instead? 34 | validations: 35 | required: true 36 | - type: textarea 37 | id: screenshots 38 | attributes: 39 | label: Screenshots/Videos 40 | description: Provide a screenshot and/or video demonstrating the issue being experienced. 41 | validations: 42 | required: false 43 | - type: textarea 44 | id: information 45 | attributes: 46 | label: Client and System Information 47 | description: What is the browser/library/client you are using? What operating system and version? 48 | validations: 49 | required: true 50 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/app-subscriptions-bug-report.yml: -------------------------------------------------------------------------------- 1 | name: App Subscriptions Bug Report 2 | description: A bug has been found in Discord's App Subscriptions. 3 | labels: ["bug", "premium-apps"] 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: "Before opening a new issue, please search existing issues: https://github.com/discord/discord-api-docs/issues?q=is%3Aissue+label%3A%22premium-apps%22" 8 | - type: textarea 9 | id: description 10 | attributes: 11 | label: Description 12 | description: Provide a clear and concise description of what the problem is. 13 | validations: 14 | required: true 15 | - type: textarea 16 | id: steps 17 | attributes: 18 | label: Steps to Reproduce 19 | description: Provide clear and concise steps for us to reliably reproduce this issue. 20 | validations: 21 | required: true 22 | - type: textarea 23 | id: expected 24 | attributes: 25 | label: Expected Behavior 26 | description: What is the behavior you expect to occur that is not? 27 | validations: 28 | required: true 29 | - type: textarea 30 | id: current 31 | attributes: 32 | label: Current Behavior 33 | description: What is the behavior you are currently seeing instead? 34 | validations: 35 | required: true 36 | - type: textarea 37 | id: screenshots 38 | attributes: 39 | label: Screenshots/Videos 40 | description: Provide a screenshot and/or video demonstrating the issue being experienced. 41 | validations: 42 | required: false 43 | - type: textarea 44 | id: information 45 | attributes: 46 | label: Client and System Information 47 | description: What is the browser/library/client you are using? What operating system and version? 48 | validations: 49 | required: true 50 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | contact_links: 3 | - name: API, Application Command, and Message Component Feature Requests 4 | url: https://github.com/discord/discord-api-docs/discussions 5 | about: Suggestions for new or different behavior in Discord's API, Gateway, OAuth2, SDK, Application Commands, Message Components, etc. 6 | - name: Developer Documentation 7 | url: https://discord.com/developers/docs 8 | about: Need documentation and examples for the API? Head over to Discord's developer documentation. 9 | - name: Discord Developers Server 10 | url: https://discord.gg/discord-developers 11 | about: Need help with the API? Talk to us in Discord's developers server. 12 | - name: Discord Feedback & Feature Requests 13 | url: https://feedback.discord.com 14 | about: Have feedback that isn't related to the API? Head over to Discord's feedback website. 15 | - name: Discord Bug Reports 16 | url: https://dis.gd/bugreport 17 | about: Have bugs that aren't related to the API? Submit a ticket to Discord's support team. 18 | - name: Discord Support 19 | url: https://dis.gd/contact 20 | about: Need something else? Submit a ticket to Discord's support team. 21 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/developer-site-bug-report.yml: -------------------------------------------------------------------------------- 1 | name: Developer Site Bug Report 2 | description: A bug has been found with Discord's Developer site or documentation. 3 | labels: ["bug", "developer portal"] 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: "Before opening a new issue, please search existing issues: https://github.com/discord/discord-api-docs/issues?q=is%3Aissue+label%3A%22developer+portal%22" 8 | - type: textarea 9 | id: description 10 | attributes: 11 | label: Description 12 | description: Provide a clear and concise description of what the problem is. 13 | validations: 14 | required: true 15 | - type: textarea 16 | id: steps 17 | attributes: 18 | label: Steps to Reproduce 19 | description: Provide clear and concise steps for us to reliably reproduce this issue. 20 | validations: 21 | required: true 22 | - type: textarea 23 | id: expected 24 | attributes: 25 | label: Expected Behavior 26 | description: What is the behavior you expect to occur that is not? 27 | validations: 28 | required: true 29 | - type: textarea 30 | id: current 31 | attributes: 32 | label: Current Behavior 33 | description: What is the behavior you are currently seeing instead? 34 | validations: 35 | required: true 36 | - type: textarea 37 | id: screenshots 38 | attributes: 39 | label: Screenshots/Videos 40 | description: Provide a screenshot and/or video demonstrating the issue being experienced. 41 | validations: 42 | required: false 43 | - type: textarea 44 | id: information 45 | attributes: 46 | label: Client and System Information 47 | description: What is the browser/library/client you are using? What operating system and version? 48 | validations: 49 | required: true 50 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/message-components-bug-report.yml: -------------------------------------------------------------------------------- 1 | name: Message Components Bug Report 2 | description: A bug has been found in Discord's Message Components. 3 | labels: ["bug", "message components"] 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: "Before opening a new issue, please search existing issues: https://github.com/discord/discord-api-docs/issues?q=is%3Aissue+label%3A%22message+components%22" 8 | - type: textarea 9 | id: description 10 | attributes: 11 | label: Description 12 | description: Provide a clear and concise description of what the problem is. 13 | validations: 14 | required: true 15 | - type: textarea 16 | id: steps 17 | attributes: 18 | label: Steps to Reproduce 19 | description: Provide clear and concise steps for us to reliably reproduce this issue. 20 | validations: 21 | required: true 22 | - type: textarea 23 | id: expected 24 | attributes: 25 | label: Expected Behavior 26 | description: What is the behavior you expect to occur that is not? 27 | validations: 28 | required: true 29 | - type: textarea 30 | id: current 31 | attributes: 32 | label: Current Behavior 33 | description: What is the behavior you are currently seeing instead? 34 | validations: 35 | required: true 36 | - type: textarea 37 | id: screenshots 38 | attributes: 39 | label: Screenshots/Videos 40 | description: Provide a screenshot and/or video demonstrating the issue being experienced. 41 | validations: 42 | required: false 43 | - type: textarea 44 | id: information 45 | attributes: 46 | label: Client and System Information 47 | description: What is the browser/library/client you are using? What operating system and version? 48 | validations: 49 | required: true 50 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/slash-command-bug-report.yml: -------------------------------------------------------------------------------- 1 | name: Slash Commands Bug Report 2 | description: A bug has been found in Discord's Slash Commands and Interactions. 3 | labels: ["bug", "slash commands"] 4 | body: 5 | - type: markdown 6 | attributes: 7 | value: "Before opening a new issue, please search existing issues: https://github.com/discord/discord-api-docs/issues?q=is%3Aissue+label%3A%22slash+commands%22" 8 | - type: textarea 9 | id: description 10 | attributes: 11 | label: Description 12 | description: Provide a clear and concise description of what the problem is. 13 | validations: 14 | required: true 15 | - type: textarea 16 | id: steps 17 | attributes: 18 | label: Steps to Reproduce 19 | description: Provide clear and concise steps for us to reliably reproduce this issue. 20 | validations: 21 | required: true 22 | - type: textarea 23 | id: expected 24 | attributes: 25 | label: Expected Behavior 26 | description: What is the behavior you expect to occur that is not? 27 | validations: 28 | required: true 29 | - type: textarea 30 | id: current 31 | attributes: 32 | label: Current Behavior 33 | description: What is the behavior you are currently seeing instead? 34 | validations: 35 | required: true 36 | - type: textarea 37 | id: screenshots 38 | attributes: 39 | label: Screenshots/Videos 40 | description: Provide a screenshot and/or video demonstrating the issue being experienced. 41 | validations: 42 | required: false 43 | - type: textarea 44 | id: information 45 | attributes: 46 | label: Client and System Information 47 | description: What is the browser/library/client you are using? What operating system and version? 48 | validations: 49 | required: true 50 | -------------------------------------------------------------------------------- /.github/dependabot.yml: -------------------------------------------------------------------------------- 1 | version: 2 2 | updates: 3 | - package-ecosystem: "github-actions" 4 | directory: "/" 5 | schedule: 6 | interval: "weekly" 7 | - package-ecosystem: "npm" 8 | directory: "/" 9 | schedule: 10 | interval: "weekly" 11 | ignore: 12 | - dependency-name: "*" 13 | update-types: 14 | ["version-update:semver-patch", "version-update:semver-minor"] 15 | -------------------------------------------------------------------------------- /.github/workflows/docs.yaml: -------------------------------------------------------------------------------- 1 | name: Verify Docs Formatting 2 | 3 | on: 4 | push: 5 | branches: 6 | - main 7 | pull_request: 8 | 9 | permissions: 10 | contents: read 11 | 12 | jobs: 13 | markdown_tables: 14 | name: Check Markdown Tables 15 | runs-on: ubuntu-latest 16 | steps: 17 | - name: Checkout repository 18 | uses: actions/checkout@v4 19 | 20 | - name: Install Node v20 21 | uses: actions/setup-node@v4 22 | with: 23 | node-version: 20 24 | cache: npm 25 | 26 | - name: Install dependencies 27 | run: npm ci 28 | 29 | - name: Check Markdown Tables 30 | run: | 31 | shopt -s globstar 32 | npx markdown-table-formatter docs/**/*.{md,mdx} --check 33 | shell: bash 34 | -------------------------------------------------------------------------------- /.github/workflows/test.yaml: -------------------------------------------------------------------------------- 1 | name: ci 2 | 3 | on: 4 | push: 5 | branches: 6 | - main 7 | pull_request: 8 | 9 | permissions: 10 | contents: read 11 | 12 | jobs: 13 | lint: 14 | name: Lint 15 | runs-on: ubuntu-latest 16 | steps: 17 | - uses: actions/checkout@v4 18 | - uses: actions/setup-node@v4 19 | with: 20 | node-version: 20 21 | cache: npm 22 | - run: npm ci 23 | - run: npm run lint 24 | - run: npm run build 25 | links: 26 | name: Check Links 27 | runs-on: ubuntu-latest 28 | steps: 29 | - uses: actions/checkout@v4 30 | - uses: actions/setup-node@v4 31 | with: 32 | node-version: 20 33 | cache: npm 34 | - run: npm ci 35 | - run: npm run test:links 36 | mdx: 37 | name: Validate mdx 38 | runs-on: ubuntu-latest 39 | steps: 40 | - uses: actions/checkout@v4 41 | - uses: actions/setup-node@v4 42 | with: 43 | node-version: 20 44 | cache: npm 45 | - run: npm ci 46 | - run: npm run test:build 47 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | *.swp 3 | node_modules/ 4 | dist/ 5 | .idea 6 | xml_output/ -------------------------------------------------------------------------------- /.prettierignore: -------------------------------------------------------------------------------- 1 | docs/ -------------------------------------------------------------------------------- /.prettierrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "printWidth": 120 3 | } 4 | -------------------------------------------------------------------------------- /LICENSE-CODE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2016 Discord 4 | 5 | Permission is hereby granted, free of charge, to any person 6 | obtaining a copy of this software and associated documentation 7 | files (the "Software"), to deal in the Software without 8 | restriction, including without limitation the rights to use, 9 | copy, modify, merge, publish, distribute, sublicense, and/or sell 10 | copies of the Software, and to permit persons to whom the 11 | Software is furnished to do so, subject to the following 12 | conditions: 13 | 14 | The above copyright notice and this permission notice shall be 15 | included in all copies or substantial portions of the Software. 16 | 17 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 18 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 19 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 20 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 21 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 22 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 23 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 24 | OTHER DEALINGS IN THE SOFTWARE. -------------------------------------------------------------------------------- /docs/change-log.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | showTOC: false 3 | --- 4 | 5 | # Change Log 6 | 7 | Discover the latest updates, new features, and bug fixes on the Discord Developer Platform. To join in on the conversation, join the [Discord Developers Server](https://discord.com/invite/discord-developers). 8 | 9 | 10 | -------------------------------------------------------------------------------- /docs/change-log/2017-07-19-breaking-change-version-6.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Breaking Change: Version 6" 3 | date: "2017-07-19" 4 | breaking: true 5 | --- 6 | 7 | * [Channel](/docs/resources/channel#channel-object) Object 8 | * `is_private` removed 9 | * [`type`](/docs/resources/channel#channel-object-channel-types) is now an integer 10 | * `recipient` is now `recipients`, an array of [user](/docs/resources/user#user-object) objects 11 | * [Message](/docs/resources/message#message-object) Object 12 | * [`type`](/docs/resources/message#message-object-message-types) added to support system messages 13 | * [Status Update](/docs/events/gateway-events#update-presence-gateway-presence-update-structure) Object 14 | * `idle_since` renamed to `since` 15 | -------------------------------------------------------------------------------- /docs/change-log/2017-07-24-new-feature-audit-logs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Feature: Audit Logs" 3 | date: "2017-07-24" 4 | --- 5 | 6 | Audit logs are here! Well, they've been here all along, but now we've got [documentation](/docs/resources/audit-log) about them. Check it out, but remember: with great power comes great responsibility. 7 | -------------------------------------------------------------------------------- /docs/change-log/2017-08-03-breaking-change-default-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Breaking Change: Default Channels" 3 | date: "2017-08-03" 4 | breaking: true 5 | --- 6 | 7 | After today, we are changing how default channels function. The "default" channel for a given user is now the channel with the highest position that their permissions allow them to see. New guilds will no longer have a default channel with the same id as the guild. Existing guilds will not have their #general channel id changed. It is possible, if permissions are set in such a way, that a user will not have a default channel in a guild. 8 | 9 | We saw a use case in many servers where the previously-default #general channel was being repurposed as an announcement-only, non-writable channel for new members by using bots to clear the entire message history. Now, that channel can simply be deleted and re-created with the desired permissions. This change also allows dynamic default channels for users based on permissions. 10 | 11 | We are also rolling out a change in conjunction that will allow Discord to remember your last-visited channel in a guild across sessions. Newly-joined users will be directed to the guild's default channel on first join; existing members will return to whichever channel they last visited. 12 | -------------------------------------------------------------------------------- /docs/change-log/2017-08-16-breaking-change-presence-activity-objects.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Breaking Change: Presence Activity Objects" 3 | date: "2017-08-16" 4 | breaking: true 5 | --- 6 | 7 | The `type` field in the [activity object](/docs/events/gateway-events#activity-object) for [Gateway Status Update](/docs/events/gateway-events#update-presence) and [Presence Update](/docs/events/gateway-events#presence-update) payloads is no longer optional when the activity object is not null. 8 | -------------------------------------------------------------------------------- /docs/change-log/2017-09-10-new-feature-emoji-endpoints.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Feature: Emoji Endpoints" 3 | date: "2017-09-10" 4 | --- 5 | 6 | [Emoji endpoints](/docs/resources/emoji#emoji-resource) have been added to the API. Bots can now manage guild emojis to their robo-hearts' content! 7 | -------------------------------------------------------------------------------- /docs/change-log/2017-09-20-new-feature-channel-categories.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Feature: Channel Categories" 3 | date: "2017-09-20" 4 | --- 5 | 6 | Changes have been made throughout the documentation to reflect the addition of channel categories to Discord. These includes an additional field—`parent_id`—to the base [channel](/docs/resources/channel#channel-object) object and a new [channel category example](/docs/resources/channel#channel-object-example-channel-category). 7 | -------------------------------------------------------------------------------- /docs/change-log/2017-10-16-breaking-change-api-gateway-below-v6-discontinued.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Breaking Change: API & Gateway Below v6 Discontinued" 3 | date: "2017-10-16" 4 | breaking: true 5 | --- 6 | 7 | [API](/docs/reference#api-versioning) and Gateway versions below v6 are now discontinued after being previously deprecated. Version 6 is now the default API and Gateway version. Attempting to use a version below 6 will result in an error. 8 | -------------------------------------------------------------------------------- /docs/change-log/2017-11-09-new-feature-rich-presence.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Feature: Rich Presence" 3 | date: "2017-11-09" 4 | --- 5 | 6 | Rich Presence is now live and available for all developers! Rich Presence allows developers to closely integrate with Discord in a number of new, cool ways like: 7 | 8 | * Showing more information about a user's current game in their profile 9 | * Allowing users to post invitations to join their party or spectate their game in chat 10 | * Displaying "Spectate" and "Ask to Join" buttons on users' profiles 11 | 12 | For more information, check out our [Rich Presence site](https://discord.com/rich-presence). To get started on development, [read the docs](/docs/rich-presence/overview)! 13 | -------------------------------------------------------------------------------- /docs/change-log/2018-01-03-semi-breaking-change-very-large-bot-sharding.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Semi-Breaking Change: Very Large Bot Sharding" 3 | date: "2018-01-03" 4 | breaking: true 5 | --- 6 | 7 | Additional sharding requirements and information for bots in over 100,000 guilds has been added. This requires a small change in numbers of shards for affected bots. See the [documentation](/docs/events/gateway#sharding-for-large-bots) for more information. 8 | -------------------------------------------------------------------------------- /docs/change-log/2018-01-23-deprecation-accept-invite-endpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Deprecation: Accept Invite Endpoint" 3 | date: "2018-01-23" 4 | --- 5 | 6 | The [Accept Invite](/docs/resources/invite) endpoint is deprecated starting today, and will be discontinued on March 23, 2018. The [Add Guild Member](/docs/resources/guild#add-guild-member) endpoint should be used in its place. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-01-30-enhancement-get-guild-emoji-endpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Enhancement: Get Guild Emoji Endpoint" 3 | date: "2018-01-30" 4 | --- 5 | 6 | The [Get Guild Emoji](/docs/resources/emoji#get-guild-emoji) response now also includes a user object if the emoji was added by a user. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-02-05-enhancement-new-message-properties.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Enhancement: New Message Properties" 3 | date: "2018-02-05" 4 | --- 5 | 6 | Additional `activity` and `application` fields—as well as corresponding object documentation—have been added to the [Message](/docs/resources/message#message-object) object in support of our newly-released [Spotify integration](https://support.discord.com/hc/en-us/articles/360000167212-Discord-Spotify-Connection) and previous Rich Presence enhancements. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-06-11-deprecation-rpc-online-member-count-and-members-list.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Deprecation: RPC online member count and members list" 3 | date: "2018-06-11" 4 | --- 5 | 6 | We released server changes that allow guilds to represent an incomplete state of the member list in our clients, which results in inaccurate member lists and online counts over RPC. These fields are now deprecated and will now return an empty members array and an online count of 0 moving forward. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-06-19-documentation-fix-list-of-open-dms-in-certain-payloads.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Documentation Fix: List of Open DMS in Certain Payloads" 3 | date: "2018-06-19" 4 | --- 5 | 6 | The documentation has been updated to correctly note that the `private_channels` field in the [Ready](/docs/events/gateway-events#ready) should be an empty array, as well as the response from `/users/@me/channels` for a bot user. This change has been in effect for a long time, but the documentation was not updated. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-11-30-enhancement-user-object.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Enhancement: User Object" 3 | date: "2018-11-30" 4 | --- 5 | 6 | The [User object](/docs/resources/user#user-object) now includes two new additional fields, `premium_type` and `flags`. These can be used to know the Nitro status of a user, or determine which HypeSquad house a user is in. 7 | -------------------------------------------------------------------------------- /docs/change-log/2018-12-11-documentation-dispatch-store-listings.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Documentation: Dispatch Store Listings" 3 | date: "2018-12-11" 4 | --- 5 | 6 | Dispatch documentation around store listings has been removed. Store pages for the Discord Store are now managed entirely within the [Developer Portal](https://discord.com/developers). 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-01-14-ask-to-join-rich-presence-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Ask to Join & Rich Presence SDK" 3 | date: "2019-01-14" 4 | --- 5 | 6 | Ask to Join no longer requires approval or whitelisting to use. You are welcome to create in-game UI, but all Ask to Join requests are also now handled by the Discord overlay. 7 | 8 | There have also been some small additions to the Rich Presence SDK. The previously undocumented `UpdateHandlers()` function is now documented. 9 | -------------------------------------------------------------------------------- /docs/change-log/2019-04-18-new-invite-object-fields.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Invite Object Fields" 3 | date: "2019-04-18" 4 | --- 5 | 6 | The [Invite Object](/docs/resources/invite#invite-object) now includes two additional fields, `target_user` and `target_user_type`. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-04-29-deprecation-of-discord-rpc-rich-presence-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Deprecation of Discord-RPC Rich Presence SDK" 3 | date: "2019-04-29" 4 | --- 5 | 6 | The [Discord-RPC](https://github.com/discord/discord-rpc) implementation of Rich Presence has been deprecated in favor of Discord's new GameSDK. If you're interested in using Rich Presence, please read our [SDK Starter Guide](/docs/developer-tools/game-sdk#getting-started) and check out the relevant functions in the [Activity Manager](/docs/developer-tools/game-sdk#activities). 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-05-29-added-info-around-nitro-boosting-experiment.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Added Info Around Nitro Boosting Experiment" 3 | date: "2019-05-29" 4 | --- 5 | 6 | Additional information has been documented to support [Server Nitro Boosting](https://support.discord.com/hc/en-us/articles/360028038352-Server-Boosting). This includes the addition of a few [message types](/docs/resources/message#message-object-message-types), as well as some [new fields on guilds](/docs/resources/guild#guild-object-premium-tier). Please note that this feature is currently under experimentation, and these fields may be subject to change. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-06-19-additional-team-information.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Additional Team Information" 3 | date: "2019-06-19" 4 | --- 5 | 6 | Additional information around Teams has been added to both the API and the documentation. The [Teams](/docs/topics/teams#teams) page now includes information about the team and team member objects. Additionally, the [Get Current Application Information](/docs/topics/oauth2#get-current-bot-application-information) endpoint now returns a `team` object if that application belongs to a team. That documentation has also been updated to includes fields that were missing for applications that are games sold on Discord. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-07-18-bot-tokens-for-achievements.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Bot Tokens for Achievements" 3 | date: "2019-07-18" 4 | --- 5 | 6 | You can now use Bot tokens for authorization headers against the HTTP API for [Achievements](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#the-api-way). 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-08-12-more-precise-rate-limits.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "More Precise Rate Limits" 3 | date: "2019-08-12" 4 | --- 5 | 6 | You can now get more precise rate limit reset times, via a new request header. Check out the [rate limits](/docs/topics/rate-limits) documentation for more information. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-08-22-changes-to-special-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Changes to Special Channels" 3 | date: "2019-08-22" 4 | --- 5 | 6 | News Channels are now changed to Announcement Channels. Developer License owners will continue to get access to them (both existing and new). Underlying channel type (GUILD\_NEWS = 5) remains the same. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-11-14-gamesdk-version-2.5.5.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GameSDK Version 2.5.5" 3 | date: "2019-11-14" 4 | --- 5 | 6 | We've shipped some updates to the GameSDK, including support for Linux as well as the IL2CPP backend system for Unity. These changes also fixed a bug in the [`SetUserAchievement()`](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#setuserachievement) method. 7 | 8 | Get the latest at the top of the [Getting Started](/docs/developer-tools/game-sdk#step-1-get-the-sdk) documentation. If you're looking for help interacting with the GameSDK or want to report a bug, join us on the [official Discord](https://discord.gg/discord-developers). 9 | -------------------------------------------------------------------------------- /docs/change-log/2019-11-27-gamesdk-version-2.5.6.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GameSDK Version 2.5.6" 3 | date: "2019-11-27" 4 | --- 5 | 6 | Fixed a bug from the 2.5.5 release that caused network handshakes to fail, resulting in no networking data being sent. The networking manager and integrated lobby networking should be full operational again after updating. 7 | -------------------------------------------------------------------------------- /docs/change-log/2019-12-06-ip-discovery-updates.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "IP Discovery Updates" 3 | date: "2019-12-06" 4 | --- 5 | 6 | Updated our [IP discovery message](/docs/topics/voice-connections#ip-discovery). The old message is deprecated and will be removed in the future. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-02-14-gateway-intents.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Gateway Intents" 3 | date: "2020-02-14" 4 | --- 5 | 6 | We've added documentation around a brand new feature: [Gateway Intents!](/docs/events/gateway#gateway-intents) Gateway Intents are a great way to specify which events you want to receive from our gateway. Go on, save yourself some bandwidth and CPU usage. 7 | 8 | Using Intents will change the behavior of some existing events and commands, so please refer to: 9 | 10 | * [Guild Create](/docs/events/gateway-events#guild-create) 11 | * [Request Guild Members](/docs/events/gateway-events#request-guild-members) 12 | * [Guild Member Add](/docs/events/gateway-events#guild-member-add) 13 | * [Guild Member Remove](/docs/events/gateway-events#guild-member-remove) 14 | * [Guild Member Update](/docs/events/gateway-events#guild-member-update) 15 | * [Presence Update](/docs/events/gateway-events#presence-update) 16 | * [List Guild Members](/docs/resources/guild#list-guild-members) 17 | -------------------------------------------------------------------------------- /docs/change-log/2020-02-26-rich-presence-spectate-approval.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Rich Presence Spectate Approval" 3 | date: "2020-02-26" 4 | --- 5 | 6 | The [Spectate](/docs/developer-tools/game-sdk#onactivityspectate) functionality of Rich Presence no longer requires whitelisting or approval. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-03-02-new-invite-events-and-reactions-endpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Invite Events and Reactions Endpoint" 3 | date: "2020-03-02" 4 | --- 5 | 6 | We've added a new endpoint for deleting all reactions of a specific emoji from a message, as well as some new invite and reaction gateway events. Read more: 7 | 8 | * [Delete All Reactions for Emoji](/docs/resources/message#delete-all-reactions-for-emoji) 9 | * [Invite Create](/docs/events/gateway-events#invite-create) 10 | * [Invite Delete](/docs/events/gateway-events#invite-delete) 11 | * [Message Reaction Remove Emoji](/docs/events/gateway-events#message-reaction-remove-emoji) 12 | -------------------------------------------------------------------------------- /docs/change-log/2020-03-03-new-allowed-mentions-object.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Allowed Mentions Object" 3 | date: "2020-03-03" 4 | --- 5 | 6 | We've added a way to specify mentions in a more granular form. This change also begins the start of a 60 day deprecation cycle on legacy mention behavior. Read more: 7 | 8 | * [Allowed mentions object](/docs/resources/message#allowed-mentions-object) 9 | -------------------------------------------------------------------------------- /docs/change-log/2020-04-24-new-properties-on-guild-members-chunk-event.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Properties on Guild Members Chunk Event" 3 | date: "2020-04-24" 4 | --- 5 | 6 | The [Guild Members Chunk](/docs/events/gateway-events#guild-members-chunk) gateway event now contains two properties: `chunk_index` and `chunk_count`. These values can be used to keep track of how many events you have left to receive in response to a [Request Guild Members](/docs/events/gateway-events#request-guild-members) command. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-05-11-legacy-mention-behavior-deprecation.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Legacy Mention Behavior Deprecation" 3 | date: "2020-05-11" 4 | --- 5 | 6 | The legacy mention behavior for bots is now removed, and granular control of mentions should use the [Allowed Mentions](/docs/resources/message#allowed-mentions-object) API moving forwards. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-07-28-new-permission-fields.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Permission Fields" 3 | date: "2020-07-28" 4 | --- 5 | 6 | Documented `permissions_new`, `allow_new`, and `deny_new` as string-serialized permission bitfields. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-10-27-gateway-v6-intent-restrictions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Gateway v6 Intent Restrictions" 3 | date: "2020-10-27" 4 | --- 5 | 6 | The v6 gateway now applies the restrictions for gateway intents. This means the new chunking limitations are now in effect, regardless of intents being used. See [Request Guild Members](/docs/events/gateway-events#request-guild-members) for further details. 7 | Additionally, if privileged intents are not enabled in the application dashboard the bot will not receive the events for those intents. 8 | 9 | All other intents are always enabled by default unless specified otherwise by the identify payload. We have made a support article to explain some of the changes and resulting issues with more details: [Gateway Update FAQ](https://dis.gd/gwupdate) 10 | -------------------------------------------------------------------------------- /docs/change-log/2020-11-13-stickers.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Stickers" 3 | date: "2020-11-13" 4 | --- 5 | 6 | Stickers are now documented as part of the [message](/docs/resources/message#message-object) object. 7 | -------------------------------------------------------------------------------- /docs/change-log/2020-11-16-inline-replies.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Inline Replies" 3 | date: "2020-11-16" 4 | --- 5 | 6 | Inline Replies have been added to our documentation. They behave differently in v6 and v8, so be cautious in your implementation: 7 | 8 | * Inline replies are type `19` in v8, but remain type `0` in v6 9 | * You can now add a `message_reference` on message create to create a reply 10 | * A new field `referenced_message` has been added to the [Message Object](/docs/resources/message#message-object) 11 | * A new field `replied_user` has been added to the [Allowed Mentions Object](/docs/resources/message#allowed-mentions-object) 12 | * [Message Create](/docs/events/gateway-events#message-create) gateway event is guaranteed to have a `referenced_message` if the message created is a reply. Otherwise, that field is not guaranteed. 13 | -------------------------------------------------------------------------------- /docs/change-log/2020-12-15-slash-commands-and-interactions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Slash Commands and Interactions" 3 | date: "2020-12-15" 4 | --- 5 | 6 | Slash Commands are here! There's a *lot* to cover, so go check out specific documentation under [Slash Commands](/docs/interactions/application-commands). 7 | 8 | Slash Commands include some new features for webhooks as well: 9 | 10 | * Webhooks can now update previously-sent messages from the same webhook using [Edit Webhook Message](/docs/resources/webhook#edit-webhook-message) and [Delete Webhook Message](/docs/resources/webhook#delete-webhook-message) 11 | 12 | This PR also documents the `application` field on the `READY` gateway event, which is a partial [application object](/docs/resources/application#application-object) containing `id` and `flags`. 13 | -------------------------------------------------------------------------------- /docs/change-log/2021-01-22-change-to-permission-checking-when-creating-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Change to Permission Checking when Creating Channels" 3 | date: "2021-01-22" 4 | --- 5 | 6 | Permission overwrites in the guild channel creation endpoint are now validated against the permissions your bot has in the guild. Permission overwrites specified in the request body when creating guild channels will now require your bot to also have the permissions being applied. Setting `MANAGE_ROLES` permission in channel overwrites is only possible for guild administrators or users with `MANAGE_ROLES` as a permission overwrite in the channel. 7 | -------------------------------------------------------------------------------- /docs/change-log/2021-02-09-slash-commands-in-dms.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Slash Commands in DMs" 3 | date: "2021-02-09" 4 | --- 5 | 6 | Slash Commands are now supported in DMs with bots. Due to this change, some of the fields on the [Interaction object](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) have been made optional. Newly optional fields don't reflect any behavior changes in Slash Commands within guilds; they are to support commands in the context of a DM only. 7 | -------------------------------------------------------------------------------- /docs/change-log/2021-03-05-changes-to-slash-command-response-types-and-flags.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Changes to Slash Command Response Types and Flags" 3 | date: "2021-03-05" 4 | --- 5 | 6 | Changes to interaction response types have been made to support better designs for application commands: 7 | 8 | * Type `2` `Acknowledge` has been deprecated 9 | * Type `3` `ChannelMessage` has been deprecated 10 | * Type `5` `AcknowledgeWithSource` has been renamed to `DeferredChannelMessageWithSource` 11 | 12 | These deprecated types will be removed and break on **April 9, 2021**. 13 | 14 | Additionally, `flags` has been documented on [InteractionApplicationCommandCallbackData](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-data-structure). Setting `flags` to `64` will make the interaction response ephemeral. 15 | -------------------------------------------------------------------------------- /docs/change-log/2021-03-15-large-bot-sharding-lowered-to-150-000-guilds.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Large Bot Sharding Lowered to 150,000 Guilds" 3 | date: "2021-03-15" 4 | --- 5 | 6 | There have been reports that sessions have higher frequency of errors when starting if a bot has joined too many guilds (the gateway connection times out). To account for this we have lowered the requirement for large bot sharding down to 150,000 guilds in order to improve reliability. 7 | -------------------------------------------------------------------------------- /docs/change-log/2021-04-05-application-command-permissions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Application Command Permissions" 3 | date: "2021-04-05" 4 | --- 5 | 6 | Need to keep some of your commands safe from prying eyes, or only available to the right people? Commands now support [command permissions](/docs/interactions/application-commands#permissions)! 7 | 8 | You can enable or disable a command (guild or global) for a specific user or role in a guild. For now, users will still be able to see the commands, but won't be able to use them. 9 | 10 | New routes have been added to support this functionality: 11 | 12 | * [`GET Guild Application Command Permissions`](/docs/interactions/application-commands#get-guild-application-command-permissions) 13 | * [`GET Application Command Permissions`](/docs/interactions/application-commands#get-application-command-permissions) 14 | * [`PUT Application Command Permissions`](/docs/interactions/application-commands#batch-edit-application-command-permissions) 15 | 16 | A `default_permission` field has also been added to the [ApplicationCommand](/docs/interactions/application-commands#application-command-object-application-command-structure) model. This field allows you to disable commands for everyone in a guild by default, if you prefer to make some of your commands an opt-in experience. 17 | -------------------------------------------------------------------------------- /docs/change-log/2021-04-28-api-v9.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "API v9" 3 | date: "2021-04-28" 4 | --- 5 | 6 | API v9 is now available. 7 | 8 | API v9 includes support for [threads](/docs/topics/threads), an upcoming feature. Older API versions will not receive any Gateway Events for threads, so it is important to update soon! We've prepared a [migration guide](/docs/topics/threads) to help make the upgrade process very straightforward. 9 | 10 | This documentation is being published early so bots can have at least two months to upgrade before threads launch. 11 | 12 | Additionally, API v9 also removes the `/channels/:id/messages/:id/suppress-embeds` route. 13 | -------------------------------------------------------------------------------- /docs/change-log/2021-05-26-buttons-and-message-components.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Buttons and Message Components" 3 | date: "2021-05-26" 4 | --- 5 | 6 | Message components are now available with our first two components: a layout-based `ActionRow` and...buttons! 7 | 8 | You can now include buttons on messages sent by your app, whether they're bot messages or responses to interactions. [Learn more about message components](/docs/components/overview). 9 | 10 | The addition of message components means new fields and response types: 11 | 12 | * An optional `components` field has been added to the [message object](/docs/resources/message#message-object) 13 | * New response types `6` and `7` have been added for [interaction responses](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type), valid only for component-based interactions 14 | -------------------------------------------------------------------------------- /docs/change-log/2021-06-10-support-for-multiple-embeds-in-message-routes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Support for Multiple Embeds in Message Routes" 3 | date: "2021-06-10" 4 | --- 5 | 6 | Message routes now accept an embeds array in addition to the existing embed field. Bots can now send up to 10 embeds per message, to be consistent with webhook behavior. The existing embed field is considered deprecated and will be removed in the next API version. 7 | -------------------------------------------------------------------------------- /docs/change-log/2021-06-30-select-menu-components.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Select Menu Components" 3 | date: "2021-06-30" 4 | --- 5 | 6 | Select Menus are now part of the components API! They're the greatest thing since the invention of buttons yesterday. Select menus allow you to offer users a choice of one or many options in a friendly UI-based way. 7 | 8 | Select menus can be used like other [message components](/docs/components/overview). Learn all the specifics in the [documentation](/docs/components/reference#string-select). 9 | -------------------------------------------------------------------------------- /docs/change-log/2021-08-10-user-and-message-commands.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "User and Message Commands" 3 | date: "2021-08-10" 4 | --- 5 | 6 | [User commands](/docs/interactions/application-commands#user-commands) and [message commands](/docs/interactions/application-commands#message-commands) are now live! These commands appear on context menus for users and messages, with more to come in the future. 7 | 8 | Context menu commands are a type of application command. The "Slash Commands" documentation page has been renamed to "Application Commands" and split out by type to show this. 9 | -------------------------------------------------------------------------------- /docs/change-log/2021-09-16-updated-thread-permissions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Updated Thread Permissions" 3 | date: "2021-09-16" 4 | --- 5 | 6 | Thread permissions have been updated and simplified: 7 | 8 | * "Use Public Threads" is now "Create Public Threads", which allows users to create public threads and announcement threads in a channel, even if they cannot send messages in that channel. 9 | * "Use Private Threads" is now "Create Private Threads", which allows users to create private threads in a channel, even if they cannot send messages in that channel. 10 | 11 | A new permission has also been added: 12 | 13 | * "Send Messages in Threads", which allows users to send a message in a thread. The "Send Messages" permission has no effect in threads: users **must** have "Send Messages in Threads" to send a message in a thread. This allows for setups where a user can participate in a thread but cannot send a message in the parent channel (like a thread on an announcement post). 14 | -------------------------------------------------------------------------------- /docs/change-log/2021-10-27-application-command-autocomplete-interactions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Application Command Autocomplete Interactions" 3 | date: "2021-10-27" 4 | --- 5 | 6 | Autocomplete interactions are now available, allowing application commands to provide server completed options. Check out [the autocomplete interaction docs](/docs/interactions/application-commands#autocomplete) for more information. 7 | -------------------------------------------------------------------------------- /docs/change-log/2021-11-23-guild-scheduled-events.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Scheduled Events" 3 | date: "2021-11-23" 4 | --- 5 | 6 | * Add official support for `guild_scheduled_events` field on `Guild` resource sent with `GUILD_CREATE` event 7 | 8 | #### Nov 18, 2021 9 | 10 | * Breaking change for return type for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}/users` 11 | * Add `with_user_count` query param for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}` 12 | * Return additional `creator` field by default in response for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}` 13 | * More details and clarification for the guild scheduled events feature. 14 | * Document support for `before` and `after` query params for `GET /guilds/{guild.id}/scheduled-events/{guild_scheduled_event.id}/users` 15 | 16 | #### Nov 15, 2021 17 | 18 | Add new documentation for the recently released Guild Scheduled Events feature. 19 | -------------------------------------------------------------------------------- /docs/change-log/2021-12-20-guild-member-timeouts.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Member Timeouts" 3 | date: "2021-12-20" 4 | --- 5 | 6 | Add new documentation for the recently released guild member timeout feature. 7 | -------------------------------------------------------------------------------- /docs/change-log/2022-02-08-interaction-modals-and-application-command-attachment-option-type.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Interaction Modals and Application Command Attachment Option Type" 3 | date: "2022-02-08" 4 | --- 5 | 6 | Interaction modals are now available, allowing applications to prompt users for further detailed input. Check out [the modal docs](/docs/interactions/receiving-and-responding#interaction-response-object-modal) for more information. 7 | 8 | Application Commands can now add an attachment option type. See [the option type table](/docs/interactions/application-commands#application-command-object-application-command-option-type) for more information. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-03-31-guild-bans-pagination.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Bans Pagination" 3 | date: "2022-03-31" 4 | --- 5 | 6 | The `GET /guilds/{guild.id}/bans` endpoint has been migrated to require pagination to improve reliability and stability. Check out the [endpoint docs](/docs/resources/guild#get-guild-bans) for more information. 7 | -------------------------------------------------------------------------------- /docs/change-log/2022-04-06-forum-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Forum Channels" 3 | date: "2022-04-06" 4 | --- 5 | 6 | Added new channel type, `GUILD_FORUM` (15). A `GUILD_FORUM` channel is an unreleased feature that is very similar (from an API perspective) to a `GUILD_TEXT` channel, except only threads can be created in that channel; messages cannot be sent directly in that channel. Check out the [forums topic](/docs/topics/threads#forums) for more information. 7 | -------------------------------------------------------------------------------- /docs/change-log/2022-06-16-auto-moderation.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Auto Moderation" 3 | date: "2022-06-16" 4 | --- 5 | 6 | Add new [Auto Moderation feature](/docs/resources/auto-moderation) which enables guilds to moderate message content based on keywords, harmful links, and unwanted spam. This change includes: 7 | 8 | * New endpoints for [creating](/docs/resources/auto-moderation#create-auto-moderation-rule), [updating](/docs/resources/auto-moderation#modify-auto-moderation-rule), and [deleting](/docs/resources/auto-moderation#delete-auto-moderation-rule) Auto Moderation rules 9 | * New gateway events emitted when Auto Moderation rules are [created](/docs/events/gateway-events#auto-moderation-rule-create) (`AUTO_MODERATION_RULE_CREATE`), [updated](/docs/events/gateway-events#auto-moderation-rule-update) (`AUTO_MODERATION_RULE_UPDATE `), and [deleted](/docs/events/gateway-events#auto-moderation-rule-delete) (`AUTO_MODERATION_RULE_DELETE `). Requires the `AUTO_MODERATION_CONFIGURATION` (`1 << 20`) intent 10 | * New gateway event emitted when an [action is executed](/docs/events/gateway-events#auto-moderation-action-execution) (`AUTO_MODERATION_ACTION_EXECUTION`). Requires the `AUTO_MODERATION_EXECUTION` (`1 << 21`) intent 11 | * New [audit log entries](/docs/resources/audit-log#audit-log-entry-object-audit-log-events) when rules are created (`AUTO_MODERATION_RULE_CREATE`), updated (`AUTO_MODERATION_RULE_UPDATE`), or deleted (`AUTO_MODERATION_RULE_DELETE`), or when Auto Moderation performs an action (`AUTO_MODERATION_BLOCK_MESSAGE`) 12 | -------------------------------------------------------------------------------- /docs/change-log/2022-06-17-updated-connection-property-field-names.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Updated Connection Property Field Names" 3 | date: "2022-06-17" 4 | --- 5 | 6 | The `$` prefix in [identify connection properties](/docs/events/gateway-events#identify-identify-connection-properties) are deprecated. The new field names are `os`, `browser`, and `device`. When passed, the `$`-prefixed names will resolve to the new ones. 7 | 8 | In API v11, support for the previous field names (`$os`, `$browser`, and `$device`) will be removed. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-06-21-message-content-in-auto-moderation-events.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Message Content in Auto Moderation events" 3 | date: "2022-06-21" 4 | breaking: true 5 | --- 6 | 7 | In API v10, the `MESSAGE_CONTENT` (`1 << 15`) intent is now required to receive non-empty values for the `content` and `matched_content` fields in [`AUTO_MODERATION_ACTION_EXECUTION`](/docs/events/gateway-events#auto-moderation-action-execution) gateway events. This matches the intended behavior for message content across the API. 8 | -------------------------------------------------------------------------------- /docs/change-log/2022-06-29-calculated-permissions-in-interaction-payloads.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Calculated Permissions in Interaction Payloads" 3 | date: "2022-06-29" 4 | --- 5 | 6 | Interaction payloads now contain an `app_permissions` field whose value is the computed [permissions](/docs/topics/permissions#permissions-bitwise-permission-flags) for a bot or app in the context of a specific interaction (including any channel overwrites). Similar to other permission fields, the value of `app_permissions` is a bitwise OR-ed set of permissions expressed as a string. Read details in the [interactions documentation](/docs/interactions/receiving-and-responding#interaction-object). 7 | 8 | For apps without a bot user (or without the `bot` scope), the value of `app_permissions` will be the same as the permissions for `@everyone`, but limited to the permissions that can be used in interaction responses (currently `ATTACH_FILES`, `EMBED_LINKS`, `MENTION_EVERYONE`, and `USE_EXTERNAL_EMOJIS`). 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-07-01-min-and-max-length-for-command-options.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Min and Max Length for Command Options" 3 | date: "2022-07-01" 4 | --- 5 | 6 | Application [command options](/docs/interactions/application-commands#application-command-object-application-command-option-structure) of type `STRING` now includes optional `min_length` and `max_length` fields to control the length of text a user can input. 7 | 8 | The value of `min_length` must be greater or equal to `0`, and the value of `max_length` must be greater or equal to `1`. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-07-13-upcoming-permissions-change-to-webhook-routes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Upcoming Permissions Change to Webhook Routes" 3 | date: "2022-07-13" 4 | --- 5 | 6 | On August 8th, 2022 we will begin requiring the `VIEW_CHANNEL (1 << 10)` permission for webhook routes which require `MANAGE_WEBHOOKS (1 << 29)`, to align with our documented behavior. We don't expect that many applications will be affected by this, but in case you are, please ensure you have updated permissions needed for accessing the following routes: 7 | 8 | * [`GET /webhooks/{webhook.id}`](/docs/resources/webhook#get-webhook) 9 | * [`DELETE /webhooks/{webhook.id}`](/docs/resources/webhook#delete-webhook) 10 | * [`PATCH /webhooks/{webhook.id}`](/docs/resources/webhook#modify-webhook) 11 | * [`GET /channels/{channel.id}/webhooks`](/docs/resources/webhook#get-channel-webhooks) 12 | * [`POST /channels/{channel.id}/webhooks`](/docs/resources/webhook#create-webhook) 13 | -------------------------------------------------------------------------------- /docs/change-log/2022-08-09-session-specific-gateway-resume-urls.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Session-specific Gateway Resume URLs" 3 | date: "2022-08-09" 4 | --- 5 | 6 | :::warn 7 | Starting on **September 12, 2022**, apps that aren’t using the new `resume_gateway_url` field to resume gateway sessions will be disconnected significantly faster than normal. 8 | ::: 9 | 10 | A new `resume_gateway_url` field has been added to the [Ready](/docs/events/gateway-events#ready) gateway event to support session-specific gateway connections. The value of `resume_gateway_url` is a session-specific URL that should be used when resuming the gateway session after a disconnect. Previously, `wss://gateway.discord.gg` was used to connect *and* resume sessions, but should now only be used during the connection. 11 | 12 | At the moment, the value of `resume_gateway_url` will always be `wss://gateway.discord.gg` to give developers more time to adopt the new field. In the near future, the value will change to the session-specific URLs. 13 | -------------------------------------------------------------------------------- /docs/change-log/2022-08-22-slash-command-mentions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Slash Command Mentions" 3 | date: "2022-08-22" 4 | --- 5 | 6 | This week, [Slash Command mentions](/docs/reference#message-formatting) are rolling out across all Discord clients (for Android, mentions are limited to the [React Native client](https://discord.com/blog/android-react-native-framework-update)). Clicking a Slash Command mention will auto-populate the command in the user's message input. 7 | 8 | Slash Command mentions use the following format: ``. You can also use `` and `` for subcommands and subcommand groups. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-09-14-forum-channels-release.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Forum Channels Release" 3 | date: "2022-09-14" 4 | --- 5 | 6 | Forum channels ([`GUILD_FORUM` or `15`](/docs/resources/channel#channel-object-channel-types)) have been released to all community servers. `GUILD_FORUM` channels are a new channel type that only supports threads, which display differently than in text (`GUILD_TEXT`) channels. 7 | 8 | Check out the [forums topic](/docs/topics/threads#forums) for more information on the relevant APIs and technical details, and the [Forums FAQ](https://support.discord.com/hc/en-us/articles/6208479917079-Forum-Channels-FAQ#h_01G69FJQWTWN88HFEHK7Z6X79N) for more about the feature. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-09-21-auto-moderation-spam-and-mention-spam-trigger-types.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Auto Moderation Spam and Mention Spam Trigger Types" 3 | date: "2022-09-21" 4 | --- 5 | 6 | Two new [trigger types](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types) were added to Auto Moderation: 7 | 8 | * `MENTION_SPAM` blocks messages that mention more than a set number of unique server members or roles. Apps can define the number (up to 50) using the `mention_total_limit` field in the [trigger metadata object](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) when creating or updating an Auto Moderation rule. 9 | * `SPAM` blocks links and messages that are identified as spam. 10 | 11 | More information can be found in the [Auto Moderation documentation](/docs/resources/auto-moderation). 12 | -------------------------------------------------------------------------------- /docs/change-log/2022-09-22-default-sort-order-for-forum-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Default Sort Order for Forum Channels" 3 | date: "2022-09-22" 4 | --- 5 | 6 | `default_sort_order` is an optional field in the [channel object](/docs/resources/channel) that indicates how the threads in a [forum channel](/docs/topics/threads#forums) will be sorted for users by default. Setting `default_sort_order` requires the `MANAGE_CHANNELS` permission. 7 | 8 | If `default_sort_order` hasn't been set, its value will be `null`. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-10-13-new-select-menu-components.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New Select Menu Components" 3 | date: "2022-10-13" 4 | --- 5 | 6 | Four new select menu [component types](/docs/components/reference#component-object-component-types) have been added to make it easier to populate selects with common resources in Discord: 7 | 8 | * User select (type `5`) 9 | * Role select (type `6`) 10 | * Mentionable (user *and* role) select (type `7`) 11 | * Channel select (type `8`) 12 | 13 | The new select menu components are defined similarly to the existing string select menu—with the exception of not including the `options` field and, within channel select menus, having the option to include a `channel_types` field. The [select menu interaction](/docs/components/reference#string-select-string-select-interaction) apps receive also contain a [`resolved` field](/docs/components/reference#string-select-select-menu-resolved-object) for the new components. 14 | 15 | More details can be found in the updated [select menu documentation](/docs/components/reference#component-object-component-types). 16 | -------------------------------------------------------------------------------- /docs/change-log/2022-10-20-delete-ephemeral-messages.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Delete Ephemeral Messages" 3 | date: "2022-10-20" 4 | --- 5 | 6 | Ephemeral interaction responses and follow-ups can now be deleted with a valid interaction token using the following endpoints: 7 | 8 | * [`DELETE /webhooks///messages/@original`](/docs/interactions/receiving-and-responding#delete-original-interaction-response) 9 | * [`DELETE /webhooks///messages/`](/docs/interactions/receiving-and-responding#delete-followup-message) 10 | 11 | As a reminder, interaction tokens stay valid for up to 15 minutes after the interaction occurs. Details can be found in the [interaction documentation](/docs/interactions/receiving-and-responding). 12 | -------------------------------------------------------------------------------- /docs/change-log/2022-11-04-add-auto-moderation-regex-support.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Auto Moderation Regex Support" 3 | date: "2022-11-04" 4 | --- 5 | 6 | Auto Moderation rules with [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types) `KEYWORD` now support 7 | a `regex_patterns` field in its [trigger\_metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types). 8 | Regex patterns are a powerful way to describe many keywords all at once using one expression. Only Rust flavored regex is supported, which can be tested in online editors such as [Rustexp](https://rustexp.lpil.uk/). 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-11-09-gamesdk-feature-deprecation.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GameSDK Feature Deprecation" 3 | date: "2022-11-09" 4 | breaking: true 5 | --- 6 | 7 | To help keep us focused on the features, improvements, and gaming-related experiences that Discord users love, we are deprecating the following pieces of the GameSDK **starting today**, and decommissioning them on **Tuesday, May 2, 2023**: 8 | 9 | * [Achievements](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md) 10 | * [Applications](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Applications.md) 11 | * [Voice](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Discord_Voice.md) 12 | * [Images](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Images.md) 13 | * [Lobbies](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Lobbies.md) 14 | * [Networking](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Networking.md) 15 | * [Relationships](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Relationships.md) 16 | * [Storage](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Storage.md) 17 | * [Store](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Store.mdmd) 18 | 19 | This deprecation period will last until **Tuesday May 2, 2023**, after which these pieces will be decommissioned and no longer work. The other pieces of the GameSDK will continue to be supported. 20 | 21 | We know that Discord is an important place for people to find belonging, and that using your Discord identity in games is a crucial part of that sense of belonging. You’ll still be able to use the GameSDK to integrate Rich Presence, relationships, entitlements, basic user information, and the overlay. 22 | -------------------------------------------------------------------------------- /docs/change-log/2022-11-22-add-auto-moderation-allow-list-for-keyword-rules-and-increase-max-keyword-rules-per-guild-limit.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Auto Moderation Allow List for Keyword Rules and Increase Max Keyword Rules Per Guild Limit" 3 | date: "2022-11-22" 4 | --- 5 | 6 | * Auto Moderation rules with [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types) `KEYWORD` now support an `allow_list` field in its [trigger\_metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata). Any message content that matches an `allow_list` keyword will be ignored by the Auto Moderation `KEYWORD` rule. Each `allow_list` keyword can be a multi-word phrase and can contain [wildcard symbols](/docs/resources/auto-moderation#auto-moderation-rule-object-keyword-matching-strategies). 7 | * Increase maximum number of rules with `KEYWORD` [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types) per guild from 3 to 5 8 | * Increase maximum length for each regex pattern in the `regex_patterns` [trigger\_metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) field from 75 to 260. 9 | -------------------------------------------------------------------------------- /docs/change-log/2022-12-12-add-application-connections-metadata-and-linked-roles.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Application Connections Metadata and Linked Roles" 3 | date: "2022-12-12" 4 | --- 5 | 6 | Introducing [linked roles](https://discord.com/blog/connected-accounts-functionality-boost-linked-roles) as well as the ability for all developers to set up their own linked roles with an application. This includes: 7 | 8 | * New [`role_connections_verification_url`](/docs/resources/application#application-object) that can be set in the developer portal in order for the application to render as potential verification option for linked roles. 9 | * [Application metadata](/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) to specify more detailed linked role requirements. 10 | * New endpoints to [retrieve](/docs/resources/application-role-connection-metadata#get-application-role-connection-metadata-records) (`GET /applications//role-connections/metadata`) and [update](/docs/resources/application-role-connection-metadata#update-application-role-connection-metadata-records) (`PUT /applications//role-connections/metadata`) application connection metadata. 11 | * New [`role_connections.write`](/docs/topics/oauth2#shared-resources-oauth2-scopes) OAuth2 scope required to authenticate the below requests. 12 | * Endpoints to [retrieve](/docs/resources/user#get-current-user-application-role-connection) (`GET /users/@me/applications/{application.id}/role-connection`) and [update](/docs/resources/user#update-current-user-application-role-connection) (`PUT /users/@me/applications/{application.id}/role-connection`) a user's role connections, both of which return an [application role connection](/docs/resources/user#application-role-connection-object) object. 13 | 14 | :::info 15 | For a quick rundown on how to get started using linked roles, refer to the [tutorial](/docs/tutorials/configuring-app-metadata-for-linked-roles). 16 | ::: 17 | -------------------------------------------------------------------------------- /docs/change-log/2022-12-13-add-default-layout-setting-for-forum-channels.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Default Layout setting for Forum channels" 3 | date: "2022-12-13" 4 | --- 5 | 6 | `default_forum_layout` is an optional field in the [channel object](/docs/resources/channel) that indicates the default layout for posts in a [forum channel](/docs/topics/threads#forums). A value of 1 (`LIST_VIEW`) indicates that posts will be displayed as a chronological list, and 2 (`GALLERY_VIEW`) indicates they will be displayed as a collection of tiles. If `default_forum_layout` hasn't been set, the value will be `0`. 7 | 8 | Setting `default_forum_layout` requires the `MANAGE_CHANNELS` permission. 9 | -------------------------------------------------------------------------------- /docs/change-log/2023-01-09-thread-member-details-and-pagination.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Thread Member Details and Pagination" 3 | date: "2023-01-09" 4 | breaking: true 5 | --- 6 | 7 | A new `member` field was added to the [thread member object](/docs/resources/channel#thread-member-object). `member` is a [guild member object](/docs/resources/guild#guild-member-object) that will be included within returned thread member objects when the new `with_member` field is set to `true` in the [List Thread Members](/docs/resources/channel#list-thread-members) (`GET /channels//thread-members`) and [Get Thread Member](/docs/resources/channel#get-thread-member) (`GET /channels//thread-members/`) endpoints. 8 | 9 | Setting `with_member` to `true` will also enable pagination for the [List Thread Members](/docs/resources/channel#list-thread-members) endpoint. When the results are paginated, you can use the new `after` and `limit` fields to fetch additional thread members and limit the number of thread members returned. By default, `limit` is 100. 10 | 11 | #### Upcoming Changes 12 | 13 | Starting in API v11, [List Thread Members](/docs/resources/channel#list-thread-members) (`GET /channels//thread-members`) will *always* return paginated results, regardless of whether `with_member` is passed or not. 14 | -------------------------------------------------------------------------------- /docs/change-log/2023-01-18-guild-audit-log-events.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Audit Log Events" 3 | date: "2023-01-18" 4 | --- 5 | 6 | At long last, a new [`GUILD_AUDIT_LOG_ENTRY_CREATE`](/docs/events/gateway-events#guild-audit-log-entry-create) event has been added to the gateway, allowing your application to react to moderation actions in guilds. The `VIEW_AUDIT_LOG` permission is required in order to receive these events, and the [`GUILD_MODERATION` intent](/docs/events/gateway#gateway-intents) needs to be set when connecting to the gateway. 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-02-08-increase-auto-moderation-keyword-limits.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Increase Auto Moderation Keyword Limits" 3 | date: "2023-02-08" 4 | --- 5 | 6 | * Increase maximum number of rules with `KEYWORD` [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types) per guild from 5 to 6 7 | * Increase maximum length for each keyword in the `keyword_filter` and `allow_list` [trigger\_metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) fields from 30 to 60. 8 | -------------------------------------------------------------------------------- /docs/change-log/2023-02-10-update-to-locked-threads.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Update to Locked Threads" 3 | date: "2023-02-10" 4 | --- 5 | 6 | ### Upcoming Changes 7 | 8 | Currently, threads in Discord (including forum posts) can either be archived or both locked and archived. Starting on **March 6, 2023**, threads will be able to be locked *without* being archived, which will slightly change the meaning of the [`locked` field](/docs/resources/channel#thread-metadata-object-thread-metadata-structure). 9 | 10 | `locked` currently indicates that a thread cannot be reopened by a user without the [`MANAGE_THREADS` (`1 << 34`) permission](/docs/topics/permissions#permissions-bitwise-permission-flags), but it doesn't restrict user activity within active (meaning non-archived) threads. After this change, users (including bot users) without the `MANAGE_THREADS` permission will be more restricted in locked threads. Users won't be able to create or update messages in locked threads, or update properties like its title or tags. Additionally, some user activity like deleting messages and adding or removing reactions will *only* be allowed in locked threads if that thread is also active (or un-archived). 11 | 12 | If a user or bot user has the `MANAGE_THREADS` permission, they will still be able to make changes to the thread and messages. The upcoming change does not affect the meaning of the [`archived` field](/docs/resources/channel#thread-metadata-object-thread-metadata-structure) or the behavior of a thread that is both locked and archived. 13 | 14 | ### How do I prepare for this change? 15 | 16 | If your app is interacting with threads (including forum posts), it should check the state of the `locked` and/or `archived` field for the thread to understand which actions it can or cannot perform. It should also be prepared to handle any errors that it may receive when a thread is locked. 17 | -------------------------------------------------------------------------------- /docs/change-log/2023-02-24-add-auto-moderation-custom-message-action-metadata-field.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Auto Moderation custom_message Action Metadata Field" 3 | date: "2023-02-24" 4 | --- 5 | 6 | Add new `custom_message` [action metadata](/docs/resources/auto-moderation#auto-moderation-action-object-action-metadata) for the `BLOCK_MESSAGE` [action type](/docs/resources/auto-moderation#auto-moderation-action-object-action-types)). You can now specify a custom string for every Auto Moderation rule that will be shown to members whenever the rule blocks their message. This can be used as an additional explanation for why a message was blocked and as a chance to help members understand your server's rules and guidelines. 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-04-06-interaction-channel-data.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Interaction Channel Data" 3 | date: "2023-04-06" 4 | --- 5 | 6 | Interactions now contain a `channel` field which is a partial channel object and guaranteed to contain `id` and `type`. We recommend that you begin using this channel field to identify the source channel of the interaction, and may deprecate the existing `channel_id` field in the future. See the [interaction documentation](/docs/interactions/receiving-and-responding#interaction-object) for more details. 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-04-14-bot-users-added-to-all-new-apps.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Bot users added to all new apps" 3 | date: "2023-04-14" 4 | --- 5 | 6 | Starting today, [bot users](/docs/topics/oauth2#bot-vs-user-accounts) will be added to all newly-created apps. Settings and configuration options for bot users remain the same, and can still be accessed on the **Bot** page within your [app's settings](https://discord.com/developers/applications). 7 | 8 | If your app doesn't need or want a bot user associated with it, you can refrain from adding the [`bot` scope](/docs/topics/oauth2#shared-resources-oauth2-scopes) when installing your app. 9 | -------------------------------------------------------------------------------- /docs/change-log/2023-05-05-add-join-raid-and-mention-raid-fields.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Join Raid and Mention Raid fields" 3 | date: "2023-05-05" 4 | --- 5 | 6 | * Add Auto Moderation `mention_raid_protection_enabled` [trigger\_metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) field for the `MENTION_SPAM` [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types). If this field and its parent `MENTION_SPAM` rule are enabled, Auto Moderation provides baseline detection against sudden spikes in mention activity that are normally indicative of mention raids. 7 | * Add `safety_alerts_channel_id` [guild](/docs/resources/guild#guild-object) field and [`RAID_ALERTS_DISABLED` guild feature flag](/docs/resources/guild#guild-object-guild-features) which are associated with join raid protection 8 | -------------------------------------------------------------------------------- /docs/change-log/2023-08-01-new-guild-media-channel-type.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "New GUILD_MEDIA channel type" 3 | date: "2023-08-01" 4 | --- 5 | 6 | * Add the [`GUILD_MEDIA` (16) channel type](/docs/resources/channel#channel-object-channel-types). `GUILD_MEDIA` channels only support threads, similar to `GUILD_FORUM` channels. 7 | 8 | Read the [media channel topic](/docs/topics/threads#media-channels) for more information on the relevant APIs and technical details, or the [media channel Help Center Article](https://creator-support.discord.com/hc/en-us/articles/14346342766743) for more about the feature. 9 | -------------------------------------------------------------------------------- /docs/change-log/2023-08-02-public-preview-of-openapi-3.1-specification.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Public Preview of OpenAPI 3.1 Specification" 3 | date: "2023-08-02" 4 | --- 5 | 6 | We're introducing an [OpenAPI 3.1 spec](https://github.com/discord/discord-api-spec) in public preview to make it easier and more reliable to develop with the HTTP API. While our current developer documentation requires manual reviews and updates, the OpenAPI spec is generated from the source code which means it better reflects the nooks, crannies, and nuances of the Discord API. 7 | 8 | :::warn 9 | The public preview of the OpenAPI spec is subject to breaking changes without advance notice, and should not be used within production environments. If you see something that looks incorrect or can be improved, you can [open an issue](https://github.com/discord/discord-api-spec/issues). 10 | ::: 11 | 12 | The public spec can be found in the new [`discord-api-spec` repository on GitHub](https://github.com/discord/discord-api-spec). 13 | -------------------------------------------------------------------------------- /docs/change-log/2023-08-08-activity-state-for-bot-users.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Activity State for Bot Users" 3 | date: "2023-08-08" 4 | --- 5 | 6 | The `state` field in [activity objects](/docs/events/gateway-events#activity-object) can now be set when [updating presence](/docs/events/gateway-events#update-presence) for a bot user. The value of `state` will appear as a custom status for the bot user when an [activity's `type`](/docs/events/gateway-events#activity-object-activity-types) is set to `4`, or as additional data under an activity's name for other activity types. 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-08-10-embed-debugger.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Embed Debugger" 3 | date: "2023-08-10" 4 | --- 5 | 6 | We've released a new [Embed Debugger tool](https://discord.com/developers/embeds) that shows you how a URL's metadata will be parsed and rendered as a link embed within the Discord client. Use it to preview your site's embed, or debug why your site's link embed isn't working as expected. 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-08-23-team-member-roles.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Team Member Roles" 3 | date: "2023-08-23" 4 | --- 5 | 6 | You can now select roles other than admin when inviting users or configuring members of a team. There are four [role types](/docs/topics/teams#team-member-roles-team-member-role-types) that a team member can be assigned: owner, admin, developer, or read-only. The team member object now has an additional [`role` field](/docs/topics/teams#data-models-team-member-object), which is a string representing the member's current role. 7 | 8 | Details about team member roles are in the updated [Teams documentation](/docs/topics/teams#team-member-roles). 9 | -------------------------------------------------------------------------------- /docs/change-log/2023-09-22-default-value-in-auto-populated-select-menus.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Default Value in Auto-populated Select Menus" 3 | date: "2023-09-22" 4 | --- 5 | 6 | A new `default_values` field was added for user (`5`), role (`6`), mentionable (`7`), and channel (`8`) [select menu components](/docs/components/reference). `default_values` is a list of [default value objects](/docs/components/reference#user-select-select-default-value-structure), which each include an `id` (the snowflake value for the resource), as well as a corresponding `type` (either `"user"`, `"role"`, or `"channel"`). 7 | -------------------------------------------------------------------------------- /docs/change-log/2023-09-26-premium-app-subscriptions-available-in-the-us.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium App Subscriptions Available in the US" 3 | date: "2023-09-26" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | Starting today, eligible US-based developers can monetize their verified apps with App Subscriptions. [App Subscriptions](/docs/monetization/overview) let you to charge your users for premium functionality with a recurring, monthly subscription. 9 | 10 | * Manage subscription SKUs in the Developer Portal 11 | * View monetization analytics in the Developer Portal 12 | * Team owners can setup and manage payouts in Developer Portal 13 | * New endpoints for working with [SKUs](/docs/resources/sku) and [Entitlements](/docs/resources/entitlement): 14 | * [List SKUs](/docs/resources/sku#list-skus) `GET /applications//skus` 15 | * [List Entitlements](/docs/resources/entitlement#list-entitlements) `GET /applications//entitlements` 16 | * [Create Test Entitlement](/docs/resources/entitlement#create-test-entitlement) `POST /applications//entitlements` 17 | * [Delete Test Entitlement](/docs/resources/entitlement#delete-test-entitlement) `DELETE /applications//entitlements/` 18 | * [Gateway Events](/docs/events/gateway-events#entitlements) for working with entitlements: `ENTITLEMENT_CREATE`, `ENTITLEMENT_UPDATE`, `ENTITLEMENT_DELETE` 19 | * New [`PREMIUM_REQUIRED (10)` interaction response type](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type) is available to prompt users to upgrade 20 | * New `entitlements` field, which is an array of [entitlement](/docs/resources/entitlement) objects, available in interaction data payloads when [receiving and responding to interactions](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) 21 | 22 | To learn more about eligibility details and how to enable monetization for your app, check out the [Monetization Overview](/docs/monetization/overview). 23 | -------------------------------------------------------------------------------- /docs/change-log/2023-10-17-global-rate-limit-added-to-discord.com.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Global Rate Limit added to discordapp.com/*" 3 | date: "2023-10-17" 4 | --- 5 | 6 | We have added a global rate limit for API requests made to `discordapp.com/*` and may further restrict requests in the future. 7 | 8 | To limit impact on your app, please make sure you are making calls to `discord.com/*`. 9 | 10 | This does **not** apply for `cdn.discordapp.com`. 11 | 12 | Refer to the [API Reference](/docs/reference) for more info on which url(s) to use when building on the REST API 13 | 14 | * [February 14, 2022 Change Log](/docs/change-log#api-v10): Requests to v10 and higher will no longer be supported on `discordapp.com` (this does not affect `cdn.discordapp.com`) 15 | * [May 4, 2020 #api-announcements](https://discord.com/channels/613425648685547541/697138785317814292/706944540971630662) 16 | -------------------------------------------------------------------------------- /docs/change-log/2023-10-19-premium-app-subscriptions-now-available-in-the-eu-and-uk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium App Subscriptions Now Available in the EU and UK" 3 | date: "2023-10-19" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | Starting today, eligible developers based in EU and UK can now monetize their verified apps with App Subscriptions. [App Subscriptions](/docs/monetization/overview) let you to charge your users for premium functionality with a recurring, monthly subscription. 9 | 10 | :::info 11 | New features for Premium App Subscriptions are documented in the [App Subscriptions overview](/docs/monetization/overview) and in [the changelog for the previous App Subscriptions release](/docs/change-log#premium-app-subscriptions-available-in-the-us). 12 | ::: 13 | 14 | To learn more about eligibility details and how to enable monetization for your app, check out the [Monetization Overview](/docs/monetization/overview). 15 | -------------------------------------------------------------------------------- /docs/change-log/2023-11-01-fix-message-edit-interaction-response-permissions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Fix Message Edit Interaction Response Permissions" 3 | date: "2023-11-01" 4 | --- 5 | 6 | Behavior for message edit interaction response actions like [updating interaction responses](/docs/interactions/receiving-and-responding#edit-original-interaction-response) and [sending follow-up messages](/docs/interactions/receiving-and-responding#followup-messages) have been updated to follow a bot user's permissions. 7 | 8 | Previously, some message edit interaction response actions would use the default permissions rather than a bot user's permissions. 9 | -------------------------------------------------------------------------------- /docs/change-log/2023-11-29-premium-app-subscriptions-new-ways-for-testing-app-subscriptions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium App Subscriptions: New Ways for Testing App Subscriptions" 3 | date: "2023-11-29" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | Following feedback on Premium App Subscriptions, we've made it easier for developers to test their app subscriptions. The goal is to provide you with flexibility during testing and prevent you from having to use live payment methods. 9 | 10 | * Team members will automatically receive a 100% discount on a subscription for your app, allowing you to test the end-to-end payment flow 11 | * Developers can create and delete [test entitlements](/docs/resources/entitlement#create-test-entitlement) to toggle access to an application's premium features 12 | 13 | Read more about [Testing your App Subscriptions Implementation](/docs/monetization/implementing-app-subscriptions#testing-your-app-subscription-implementation) for details. 14 | -------------------------------------------------------------------------------- /docs/change-log/2023-12-01-experimenting-with-end-to-end-encryption-for-voice-video.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Experimenting with End-to-End Encryption for Voice & Video" 3 | date: "2023-12-01" 4 | topics: 5 | - "Voice" 6 | --- 7 | 8 | #### What’s Happening? 9 | 10 | As outlined in [a blog post earlier this year](https://discord.com/blog/encryption-for-voice-and-video-on-discord), we are experimenting with end-to-end encryption (e2ee) for voice and video channels. 11 | 12 | End-to-end encryption is designed to only allow the participants in a call to decipher its contents. One of the protocols we’re experimenting with is called Messaging Layer Security, which we believe would allow us to deliver end-to-end encryption at scale. Intermediaries, including platforms like Discord, are unable to access the content of communications encrypted with end-to-end encryption. 13 | 14 | #### How do I prepare for the changes? 15 | 16 | During this testing phase, there is nothing developers need to do to support end-to-end encryption. Voice channels will automatically downgrade to documented, non-e2ee protocols when a bot user joins the channel. This is transparent to the connecting client but may result in a slight delay between establishing a connection and receiving audio. 17 | 18 | #### What is planned for the future? 19 | 20 | We will be continuing our testing and will share updates along with developer documentation and sample code once it is available. 21 | 22 | Once this information is published, we will provide developers with a substantial timeframe to implement end-to-end encryption when interacting with voice and video. 23 | -------------------------------------------------------------------------------- /docs/change-log/2023-12-15-clarification-on-permission-splits-for-expressions-and-events.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Clarification on Permission Splits for Expressions and Events" 3 | date: "2023-12-15" 4 | --- 5 | 6 | :::info 7 | The existing behavior for `MANAGE_GUILD_EXPRESSIONS` and `MANAGE_EVENTS` will **not be changing**. These permissions will continue to allow your bot users to create, update and delete expressions/events. No action will be needed if you plan to continue using these permissions. 8 | ::: 9 | 10 | To support added controls for expressions and events, new [permissions](/docs/topics/permissions#permissions) were added for users and roles in July 2023: 11 | 12 | * `CREATE_GUILD_EXPRESSIONS`: `1 << 43` 13 | * `CREATE_EVENTS`: `1 << 44` 14 | 15 | These allow for creating new expressions and events, as well as editing and deleting those created by the current user. 16 | 17 | :::warn 18 | These were rolled out in July 2023 to users and roles and have been added to our developer documentation but **are not yet available to app developers**. We will share an update here when these new permissions are available in your apps. 19 | ::: 20 | -------------------------------------------------------------------------------- /docs/change-log/2023-12-19-limit-number-of-fields-in-embeds.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Limit Number of Fields in Embeds" 3 | date: "2023-12-19" 4 | --- 5 | 6 | [Embed objects](/docs/resources/message#embed-object) are now limited more explicitly to 25 [embed fields](/docs/resources/message#embed-object-embed-field-structure). If you pass more than 25 fields within the an embed's `fields` property, an error will be returned. 7 | 8 | Previously, only the first 25 embed fields would be displayed within the embed but no error was returned. 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-00-20-soundboard-api.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Soundboard API" 3 | date: "2024-09-20" 4 | --- 5 | 6 | [Soundboard](/docs/resources/soundboard) is now available in the API! Apps can now [get](/docs/resources/soundboard#list-default-soundboard-sounds) soundboard sounds, [modify](/docs/resources/soundboard#modify-guild-soundboard-sound) them, [send](/docs/resources/soundboard#send-soundboard-sound) them in voice channels, and listen to other users playing them! 7 | -------------------------------------------------------------------------------- /docs/change-log/2024-02-12-enforced-nonces-on-create-message-endpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Enforced Nonces on Create Message Endpoint" 3 | date: "2024-02-12" 4 | --- 5 | 6 | The [Create message](/docs/resources/message#create-message) endpoint now supports an `enforce_nonce` parameter. When set to true, the message will be deduped for the same sender within a few minutes. If a message was created with the same nonce, no new message will be created and the previous message will be returned instead. This behavior will become the default for this endpoint in a future API version. 7 | -------------------------------------------------------------------------------- /docs/change-log/2024-03-15-guild-prune-requiring.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Prune Requiring" 3 | date: "2024-03-15" 4 | breaking: true 5 | --- 6 | 7 | The [Get Guild Prune Count](/docs/resources/guild#get-guild-prune-count) and [Begin Guild Prune](/docs/resources/guild#begin-guild-prune) 8 | endpoints now require the `MANAGE_GUILD` permission alongside the existing `KICK_MEMBERS` requirement `₍^ >ヮ<^₎ .ᐟ.ᐟ`. 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-03-18-discord-activities-developer-preview-of-the-embedded-app-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Discord Activities: Developer Preview of the Embedded App SDK" 3 | date: "2024-03-18" 4 | topics: 5 | - "Embedded App SDK" 6 | - "Activities" 7 | --- 8 | 9 | Discord Developers can now build Activities! 10 | 11 | Activities are interactive, multiplayer experiences that run in an iframe in Discord. In order to make the communication between your experience and Discord, we've introduced the Embedded App SDK to assist in communicating between your app and the Discord client. 12 | 13 | * New [Discord Activities](/docs/activities/overview) developer docs with a tutorial, code samples, development guides, and design principles. 14 | * The Embedded App SDK is now available via [npm](https://npmjs.com/package/@discord/embedded-app-sdk) and [GitHub](http://github.com/discord/embedded-app-sdk). 15 | * The [Embedded App SDK Reference](/docs/developer-tools/embedded-app-sdk) is now available. 16 | 17 | To learn more about how to get started building your own Activity, check out the [Activities Overview](/docs/activities/overview). 18 | -------------------------------------------------------------------------------- /docs/change-log/2024-04-02-csv-export-for-premium-app-analytics.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "CSV Export for Premium App Analytics" 3 | date: "2024-04-02" 4 | --- 5 | 6 | For apps with [Monetization](/docs/monetization/overview) enabled, we have released the ability to export your SKU analytics to CSV. These exports allow you to use your preferred data tools to report on your premium offerings. 7 | 8 | You can find the export at the bottom of the `Monetization → Analytics` tab of your app to export data points such as `sales_count`, `sales_amount`, `sales_currencies`, `cancellation_count`, `refund_amount`, and `refund_count`, aggregated by each of your offerings for the selected month. 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-04-23-modify-guild-member-flags-field-permissions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Modify Guild Member flags field permissions" 3 | date: "2024-04-23" 4 | --- 5 | 6 | Update permissions necessary to modify the `flags` field when calling the [Modify Guild Member](/docs/resources/guild#modify-guild-member) endpoint. 7 | -------------------------------------------------------------------------------- /docs/change-log/2024-04-24-premium-apps-one-time-purchases-and-store.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium Apps: One-Time Purchases and Store" 3 | date: "2024-04-24" 4 | --- 5 | 6 | Two new features are now available for Premium Apps: One-Time Purchases and Stores. 7 | 8 | **One-Time Purchases** 9 | 10 | * **Durable Items**: A one-time purchase that is permanent and is not subject to either renewal or consumption, such as lifetime access to an app's premium features. 11 | * **Consumable Items**: A one-time, non-renewable purchase that provides access, such as a temporary power-up or boost in a game. 12 | 13 | Learn more about [Implementing One-Time Purchases](/docs/monetization/implementing-one-time-purchases). 14 | 15 | **A Store for Your Premium App** 16 | 17 | We have also introduced a Store for your Premium App to showcase your app subscriptions and one-time purchase items. You can now create a unique Store page within the developer portal and add your published subscription SKUs or one-time purchase SKUs to your store view, allowing your users to buy these items from your App Directory or Bot User Profile. 18 | 19 | To explore these features, eligibility details, and how to enable monetization for your app, check out the [Monetization Overview](/docs/monetization/overview). 20 | 21 | **API Documentation Updates** 22 | 23 | The following were added to our public Monetization documentation with this update: 24 | 25 | * New [SKU Object Types](/docs/resources/sku#sku-object-sku-types) 26 | * New [Entitlement Object Types](/docs/resources/entitlement#entitlement-object-entitlement-types) 27 | * [Consume an Entitlement](/docs/resources/entitlement#consume-an-entitlement) API endpoint 28 | * `consumed` field on the [Entitlement](/docs/resources/entitlement) resource 29 | -------------------------------------------------------------------------------- /docs/change-log/2024-05-31-auto-moderation-member-profile-rule.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Auto Moderation Member Profile Rule" 3 | date: "2024-05-31" 4 | --- 5 | 6 | * Add Auto Moderation `MEMBER_PROFILE` rule [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types). This rule type will check if a member's profile contains disallowed keywords. 7 | * Add Auto Moderation `BLOCK_MEMBER_INTERACTION` [action type](/docs/resources/auto-moderation#auto-moderation-action-object-action-types) currently available for the `MEMBER_PROFILE` rule [trigger\_type](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types). This action will "quarantine" the member to some extent and prevent them from performing most interactions within a specific server. 8 | -------------------------------------------------------------------------------- /docs/change-log/2024-06-17-premium-apps-new-premium-button-style-deep-linking-url-schemes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium Apps: New Premium Button Style & Deep Linking URL Schemes" 3 | date: "2024-06-17" 4 | --- 5 | 6 | **New Premium Button Style** 7 | 8 | Introduces a new `premium` [button style](/docs/components/reference#button-button-styles) to be used with a `sku_id` which points to an active [SKU](/docs/resources/sku#sku-object). This allows developers to customize their premium experience by returning specific subscription or one-time purchase products. 9 | 10 | Learn more about using [button components with interactions](/docs/components/reference#button). 11 | 12 | :::warn 13 | This change deprecates Interaction Response Type 10 14 | ::: 15 | 16 | The `PREMIUM_REQUIRED (10)` interaction response type is now deprecated in favor of using custom premium buttons. This will continue to function but may be eventually unsupported. It is recommended to migrate your bots to use the more flexible [premium button component](/docs/components/reference#button-button-styles). 17 | 18 | Learn more about [gating features with premium interactions](/docs/monetization/implementing-app-subscriptions#prompting-users-to-subscribe). 19 | 20 | **Deep Linking URL Schemes for SKUs and Store** 21 | 22 | Introduces two new url schemes for linking directly to the Application Directory. When these links are used in chat, they are rendered as rich embeds that users can interact with to launch an app's store or open a SKU detail modal. 23 | 24 | * New [Store URL Scheme](/docs/monetization/managing-skus#linking-to-your-store): `https://discord.com/application-directory/:appID/store` 25 | * New [SKU URL Scheme](/docs/monetization/managing-skus#linking-to-a-specific-sku): `https://discord.com/application-directory/:appID/store/:skuID` 26 | -------------------------------------------------------------------------------- /docs/change-log/2024-07-09-banners-in-get-current-user-guilds.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Banners in Get Current User Guilds" 3 | date: "2024-07-09" 4 | --- 5 | 6 | [`GET /users/@me/guilds`](/docs/resources/user#get-current-user-guilds) now includes each guild's `banner` field! This enables apps using OAuth2 with the `guilds` scope to display guild banners. 7 | -------------------------------------------------------------------------------- /docs/change-log/2024-07-15-message-forwarding-rollout.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Message Forwarding rollout" 3 | date: "2024-07-15" 4 | --- 5 | 6 | We are slowly rolling out the message forwarding feature to users. This feature allows callers to create a message using `message_reference.type = FORWARD` and have the API generate a `message_snapshot` for the sent message. The feature has [some limitations](/docs/resources/message#message-reference-types) and the snapshot is a minimal version of a standard `MessageObject`, but does capture the core parts of a message. 7 | 8 | The resulting message will look something like: 9 | 10 | ```json 11 | { 12 | "id": "1255957733279273083", 13 | "message_reference": { 14 | "type": 1, // Forward 15 | ... 16 | } 17 | "message_snapshots": [ 18 | { 19 | "message": { 20 | "content": "original message", 21 | "embeds": [...], 22 | "attachments": [...], 23 | ... 24 | } 25 | } 26 | ], 27 | ... 28 | } 29 | ``` 30 | 31 | We have applied stricter rate limits for this feature based on the following: 32 | 33 | * number of forwards sent by the user 34 | * total attachment size 35 | 36 | ###### API Updates since preview 37 | 38 | This was [previously announced](https://discord.com/channels/613425648685547541/697138785317814292/1233463756160503859) but note that the final API has a few changes since the API was first previewed: 39 | 40 | * [`message snapshot`](/docs/resources/message#message-snapshot-object) objects don't include a `guild` field anymore since the `message_reference` already provides that information 41 | * forwarded messages have a distinctive `message_reference` type of `FORWARD` now 42 | -------------------------------------------------------------------------------- /docs/change-log/2024-07-16-member-banners.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Guild Member Banners" 3 | date: "2024-07-16" 4 | breaking: false 5 | --- 6 | 7 | Apps can now access guild member profile banners via the API and Gateway! The [guild member object](/docs/resources/guild#guild-member-object) now includes a `banner` field which can be used to create the [guild member banner URL](/docs/reference#image-formatting). -------------------------------------------------------------------------------- /docs/change-log/2024-07-17-activities-proxy-csp-update.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Activities Proxy CSP Update" 3 | date: "2024-07-17" 4 | breaking: true 5 | --- 6 | 7 | This change will be rolled out to all existing applications on **August 28, 2024**. 8 | 9 | We will be updating our Content Security Policy (CSP) for the Activities Domain (`https://.discordsays.com`). This represents a **breaking change** for **all Activities**, and as such we have a migration plan in order. 10 | 11 | our CSP will be updated as follows: 12 | 13 | * all requests must be made through `https://.discordsays.com/.proxy/`, and requests to other paths on the `discordsays.com` domain will be blocked. 14 | * requests to `https://discord.com/api/` will be permitted, but other paths on the `discord.com` domain will be blocked. 15 | * Only allowed paths on `cdn.discordapp.com` and `media.discordapp.net` will be permitted such as `/attachments/`, `/icons/`, and `/avatars/`. 16 | * nested child iframes must also mount paths prepended by `/.proxy/` 17 | 18 | As of [embedded-app-sdk v1.4.0](https://github.com/discord/embedded-app-sdk/releases/tag/v1.4.0) we have updated `patchUrlMappings` to automatically route requests through `/.proxy/`, so updating your SDK version calling `patchUrlMappings` is a good first step. If you are unfamiliar with `patchUrlMappings`, please consult the [documentation](/docs/activities/development-guides/networking#using-external-resources). 19 | 20 | All Application IDs created after `07/17/2024 12:00:00` UTC (applicationID greater than `1263102905548800000`) will also automatically have the new CSP applied. Testing your production code on a new application created after this date is a suggested way for developers to test compliance with this new CSP. 21 | -------------------------------------------------------------------------------- /docs/change-log/2024-07-18-application-emoji.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Application Emoji" 3 | date: "2024-07-18" 4 | --- 5 | 6 | You can now upload emojis for your application in your [app's settings](https://discord.com/developers/applications) and use them as custom emojis anywhere on Discord. 7 | 8 | * Up to 2000 emojis per app 9 | * Support for user-installable apps 10 | * Can be [managed via the API](/docs/resources/emoji#create-application-emoji) with a bot token 11 | -------------------------------------------------------------------------------- /docs/change-log/2024-07-25-supported-activity-types-for-set-activity.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Supported Activity Types for SET_ACTIVITY" 3 | date: "2024-07-25" 4 | --- 5 | 6 | The [`SET_ACTIVITY` RPC command](/docs/topics/rpc#setactivity) has been updated to support 3 additional [activity types](/docs/events/gateway-events#activity-object-activity-types): Listening (`2`), Watching (`3`), and Competing (`5`). Previously, it only accepted Playing (`0`). 7 | 8 | :::warn 9 | The [Game SDK](/docs/developer-tools/game-sdk#activities) has not been updated to support setting [`ActivityType`](/docs/developer-tools/game-sdk#activitytype-enum), and is still limited to read-only (to handle events that you receive from Discord). 10 | ::: 11 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-05-voice-state-endpoints.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Voice State Endpoints" 3 | date: "2024-08-05" 4 | topics: 5 | - "Voice" 6 | - "HTTP API" 7 | --- 8 | 9 | Voice states can now be accessed over the HTTP API! Apps can use the new [Get Current User Voice State](/docs/resources/voice#get-current-user-voice-state) and [Get User Voice State](/docs/resources/voice#get-user-voice-state) endpoints to fetch a user's voice state without a Gateway connection. 10 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-09-user-app-install-count.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "User App Install Count" 3 | date: "2024-08-09" 4 | topics: 5 | - "User Apps" 6 | --- 7 | 8 | We've added an approximate user install count to the [Application object](/docs/resources/application#application-object) for user-installable apps. You can also view an app's install counts in the developer portal. 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-12-get-guild-role-endpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Get Guild Role Endpoint" 3 | date: "2024-08-12" 4 | topics: 5 | - "HTTP API" 6 | --- 7 | 8 | Need to get just one role, not the whole role list? Use the new [Get Guild Role](/docs/resources/guild#get-guild-role) endpoint to fetch a single role by ID. 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-13-voice-encryption-modes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Voice Encryption Modes" 3 | date: "2024-08-13" 4 | topics: 5 | - "Voice" 6 | --- 7 | 8 | Added documentation for voice [encryption modes](/docs/topics/voice-connections#transport-encryption-modes) `aead_aes256_gcm_rtpsize` and `aead_xchacha20_poly1305_rtpsize` while announcing the deprecation of all `xsalsa20_poly1305*` variants and `aead_aes256_gcm`. Deprecated encryption modes will be discontinued as of November 18th, 2024. 9 | 10 | :::danger 11 | Deprecated encryption modes will be discontinued as of November 18th, 2024. 12 | ::: 13 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-13-voice-gateway-version-8-and-deprecation-of-versions-older-than-4.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Voice Gateway Version 8 and Deprecation of Versions < 4" 3 | date: "2024-08-13" 4 | topics: 5 | - "Gateway" 6 | - "Voice" 7 | --- 8 | 9 | We are officially deprecating some very old voice gateway versions (> 7 years ago). 10 | 11 | * The voice gateway now supports a resume which re-sends lost messages. Use voice gateway version 8 and refer to [Buffered Resume](/docs/topics/voice-connections#buffered-resume). 12 | * We have removed the default option for voice gateway version. Once this is deprecated, you must pass a voice gateway version. 13 | 14 | :::danger 15 | You will be required to pass a voice gateway version and deprecated voice gateway versions will be discontinued as of November 18th, 2024. See [Voice Gateway Versioning](/docs/topics/voice-connections#voice-gateway-versioning) for futher details. 16 | ::: 17 | -------------------------------------------------------------------------------- /docs/change-log/2024-08-26-launching-activities-via-interactions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Launching Activities in Response to Interactions" 3 | date: "2024-08-26" 4 | topics: 5 | - "Activities" 6 | - "Interactions" 7 | --- 8 | 9 | [Activities](/docs/activities/overview) can now be launched as a response to interactions using the `LAUNCH_ACTIVITY` (type `12`) [interaction callback type](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type). `LAUNCH_ACTIVITY` can be used in response to `APPLICATION_COMMAND`, `MESSAGE_COMPONENT`, and `MODAL_SUBMIT` [interaction types](/docs/interactions/receiving-and-responding#interaction-object-interaction-type). 10 | -------------------------------------------------------------------------------- /docs/change-log/2024-09-04-add-polls-when-editing-deferred-interaction-responses.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Add Polls when Editing Deferred Interaction Responses" 3 | date: "2024-09-04" 4 | topics: 5 | - "Interactions" 6 | --- 7 | 8 | You can now create a poll while editing a deferred interaction response with the [Edit Original Interaction Response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) endpoint. Poll away! 9 | -------------------------------------------------------------------------------- /docs/change-log/2024-10-04-updates-to-entitlement-migration-guide.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Updates to Entitlement Migration Guide" 3 | date: "2024-10-07" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | The entitlement migration started on **October 1, 2024** and will continue through 11:59PM PST on **November 1, 2024**. 9 | 10 | We updated our previous entitlement migration guide to provide more up-to-date information on impacts of developer impacts. Here's a summary of the changes we made: 11 | 12 | - The migration will run through November 1, 2024 to ensure that any entitlements that are set to renew in October will be properly migrated to the new entitlement system upon renewal. 13 | - `ENTITLEMENT_UPDATE` events will only occur when a subscription ends. 14 | - The value of the `ends_at` in `ENTITLEMENT_UPDATE` events indicate the timestamp for **when the entitlement is no longer valid**. 15 | - The `ends_at` value on the [entitlement object](/docs/resources/entitlement#entitlement-object) is set when the subscription ends. 16 | - To receive the value of when a subscription was canceled, you should listen for the `SUBSCRIPTION_UPDATE` events or use the [Subscription API](/docs/resources/subscription). 17 | 18 | View the [updated migration guide](/docs/change-log#premium-apps-entitlement-migration-and-new-subscription-api). 19 | 20 | To see a full diff of the changes, refer to this pull request: [Entitlement Migration Guide Updates](https://github.com/discord/discord-api-docs/pull/7201). -------------------------------------------------------------------------------- /docs/change-log/2024-10-25-event-webhooks.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Webhook Events" 3 | date: "2024-10-25" 4 | topics: 5 | - "Events" 6 | - "User Apps" 7 | 8 | --- 9 | 10 | You can now subscribe to a limited number of HTTP-based outgoing [webhook events](/docs/events/webhook-events#event-types) after [configuring a webhook events URL](/docs/events/webhook-events#configuring-a-webhook-events-url). Currently, 3 events are available: `APPLICATION_AUTHORIZED`, `ENTITLEMENT_CREATE`, and `QUEST_USER_ENROLLMENT`. Read the [webhook events](/docs/events/webhook-events) documentation for details on subscribing and using webhook events. 11 | 12 | :::info 13 | When developing [user-installable apps](/docs/resources/application#user-context), [Application Authorized](/docs/events/webhook-events#application-authorized) (which is not available via [the Gateway](/docs/events/gateway)) is useful to receive events when your app was installed to a user or server. 14 | ::: 15 | 16 | :::warn 17 | `ENTITLEMENT_CREATE` is the only monetization-related event available using webhook events, so you should still use the Gateway for [entitlement-related events](/docs/events/gateway-events#entitlements). Other monetization-related events will be supported via webhook events soon. 18 | ::: -------------------------------------------------------------------------------- /docs/change-log/2024-11-05-post-entitlement-migration-update.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Entitlement Migration Completed" 3 | date: "2024-11-05" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | The [entitlement migration](/docs/change-log#premium-apps-entitlement-migration-and-new-subscription-api) which began on **October 1, 2024**, has been successfully completed as of **November 1, 2024**. 9 | 10 | ### What's Changed 11 | 12 | - The documentation has been updated to reflect the new entitlement system as the standard behavior. 13 | - `ENTITLEMENT_UPDATE` event for subscription-related entitlements now only occur when the subscription ends. 14 | - The `ends_at` value on the [entitlement object](/docs/resources/entitlement#entitlement-object) is now set when the subscription ends. 15 | - To determine when a subscription was canceled, listen for `SUBSCRIPTION_UPDATE` events or use the [Subscription API](/docs/resources/subscription) to retrieve the subscription's `status` and `canceled_at` timestamp. 16 | 17 | For more details about the migration process, please refer to the [migration guide](/docs/change-log#updates-to-entitlement-migration-guide). -------------------------------------------------------------------------------- /docs/change-log/2024-12-12-premium-apps-multiple-subscription-tiers.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Premium Apps: Multiple Subscription Tiers" 3 | date: "2024-12-12" 4 | topics: 5 | - "Premium Apps" 6 | --- 7 | 8 | Developers with monetization enabled can now create and publish multiple subscription SKUs of the same type for their app. This allows developers to offer different subscription tiers with varying benefits and pricing. Users can upgrade and downgrade between published subscription SKUs. 9 | 10 | ### What's Changed 11 | 12 | #### Developer Portal 13 | - Under the `Monetization` tab, you can now publish multiple subscription SKUs of the same type for your app. 14 | 15 | #### App's Store Page 16 | - When multiple subscription SKUs are published: Users can now upgrade or downgrade between different published subscription SKUs. 17 | 18 | #### User App Subscription Settings 19 | - When multiple subscription SKUs are published: Users can now upgrade or downgrade between different published subscription SKUs. 20 | - These settings are available under `User Settings → Subscriptions → App Subscriptions`. 21 | 22 | #### Subscription Object 23 | - New field `renewal_sku_ids` added to the [subscription object](/docs/resources/subscription#subscription-object) response for `SUBSCRIPTION_UPDATE` events and API endpoints. 24 | - `renewal_sku_ids` is a list of snowflakes that indicate the SKU(s) that the user will be subscribed to at renewal. 25 | 26 | #### Updated Guide: Managing SKUs 27 | - The [Managing SKUs](/docs/monetization/managing-skus#creating-a-sku) guide has been updated to include information about creating and managing multiple subscription SKUs. 28 | 29 | #### Updated Guide: Implementing App Subscriptions 30 | - The [Implementing App Subscriptions](/docs/monetization/implementing-app-subscriptions#supporting-upgrades-and-downgrades) guide has been updated to include information about supporting upgrades and downgrades between multiple subscription SKUs. -------------------------------------------------------------------------------- /docs/change-log/2024-12-17-updated-file-upload-limit.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Default File Upload Limit Change" 3 | date: "2024-12-16" 4 | breaking: true 5 | topics: 6 | - "HTTP API" 7 | - "Interactions" 8 | --- 9 | 10 | On January 16, 2025, the default file upload limit will change from 25 MiB to 10 MiB. 11 | 12 | While this limit is already active for users and bot users, it hasn't yet been applied to webhooks. 13 | 14 | - This change will take effect on January 16, 2025. 15 | - The 10 MiB limit will apply to both webhooks and interaction responses. 16 | 17 | For more information, check out [our documentation on file uploads](/docs/reference#uploading-files). -------------------------------------------------------------------------------- /docs/change-log/2025-03-17-introducing-the-discord-social-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Introducing the Discord Social SDK" 3 | date: "2025-03-17" 4 | topics: 5 | - "Discord Social SDK" 6 | --- 7 | 8 | Developers can now use the Discord Social SDK to build social features into their games, enabling friends lists, cross-platform messaging, voice and more for all players — with or without a Discord account. 9 | 10 | Discord Social SDK offers features that enhance connectivity and player engagement, including: 11 | 12 | - Account Linking 13 | - Provisional Accounts 14 | - Rich Presence 15 | - Deeplink Game Invites 16 | 17 | Additionally, available in a closed beta to support in-game communications: 18 | 19 | - Cross-Platform Messaging 20 | - Linked Channels 21 | - Voice Chat 22 | 23 | Developers can request expanded access to these available features via the closed beta. 24 | 25 | #### Discord Social SDK Developer Resources 26 | 27 | New resources are available in the Developer Portal to help you get started with the Discord Social SDK: 28 | 29 | - [Getting Started Guides](/docs/discord-social-sdk/getting-started) for C++, Unity and Unreal Engine. 30 | - [Development Guides](/docs/discord-social-sdk/development-guides) for building your game's social features. 31 | - [Design Guidelines](/docs/discord-social-sdk/design-guidelines) for designing your game's social features. 32 | - [SDK Reference](http://discord.com/developers/docs/social-sdk/index.html) is now available. 33 | - The Discord Social SDK binaries are available for download in the Developer Portal after enabling the Discord Social SDK for your application. 34 | 35 | To learn more about building with the Discord Social SDK, check out the [Discord Social SDK Overview](/docs/discord-social-sdk/overview). 36 | -------------------------------------------------------------------------------- /docs/change-log/2025-04-03-per-attachment-file-upload-limit.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Per-Attachment File Upload Behavior for Apps" 3 | date: "2025-04-03" 4 | breaking: false 5 | topics: 6 | - "HTTP API" 7 | - "Interactions" 8 | --- 9 | 10 | Starting today, file upload limits for apps are checked per-attachment rather than per-message. This change makes the app attachment behavior the same as when a user uploads multiple attachments on a single message. 11 | 12 | - File size limits now apply to each individual attachment 13 | - Previously, limits were applied to the combined size of all attachments in a message 14 | - This aligns app attachment handling with user attachment behavior 15 | 16 | The interaction payload will also include a new `attachment_size_limit` key that specifies the maximum allowed attachment size. This limit may be higher than the default attachment size limit, depending on the guild's boost status or the invoking user's Nitro status. 17 | 18 | For more information, check out [our documentation on file uploads](/docs/reference#uploading-files). -------------------------------------------------------------------------------- /docs/change-log/2025-04-11-incentivized-links.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Custom Incentivized Links" 3 | date: "2025-04-11" 4 | topics: 5 | - "Activities" 6 | - "Embedded App SDK" 7 | --- 8 | 9 | ### Custom Incentivized Links for Activities 10 | 11 | Custom Incentivized Links are used to customize how your incentivized link embed appears to users. You can create them in the developer portal or generate them from within your activity. Incentivized Links can be used as referral links, promotions, deep-linking into your activity, and more. 12 | 13 | - shareLink will now let you attach custom params to links you share about your game using `custom_id`. 14 | - Removed `referrer_id` from shareLink API. Any uses of `referrer_id` should be moved over to use `custom_id` instead. Passing `referrer_id` to shareLink will silently fail. 15 | 16 | Learn more about [creating and managing Custom Incentivized Links](/docs/activities/development-guides/growth-and-referrals#creating-and-managing-custom-incentivized-links) and [how to generate them from within your activity](/docs/activities/development-guides/growth-and-referrals#generating-a-custom-link-within-your-activity) with the shareLink API. 17 | 18 | The Embedded App SDK is available via [npm](https://www.npmjs.com/package/@discord/embedded-app-sdk) and [GitHub](https://github.com/discord/embedded-app-sdk). You can check out our [installation guide and reference](/docs/developer-tools/embedded-app-sdk) to get started with it! 19 | -------------------------------------------------------------------------------- /docs/change-log/2025-04-15-deprecating-guild-createion-by-apps.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Deprecating Guild Creation by Apps" 3 | date: "2025-04-15" 4 | topics: 5 | - "HTTP API" 6 | --- 7 | 8 | ### Breaking Change 9 | 10 | To address security concerns, we are deprecating the ability for applications to create guilds using the `Create Guild` 11 | endpoint. 12 | 13 | #### What's Changing 14 | 15 | - The Create Guild endpoint (`POST /guilds`) will be restricted for applications starting July 15, 2025 16 | - Existing Guilds owned by bots will have their ownership transferred to a real user 17 | - After the deprecation date, the endpoint will no longer be available 18 | 19 | #### Timeline 20 | 21 | - **April 15, 2025**: Deprecation announcement 22 | - **June 15, 2025**: System DM/Email notifications sent to affected app owners and designated guild members 23 | - **July 15, 2025**: `Create Guild` endpoint will no longer be available 24 | 25 | If your app is affected, you will receive a migration plan via Discord System DM. 26 | 27 | We understand this change may affect some legitimate use cases. If you have questions or believe your application 28 | requires continued access to guild creation functionality, please contact us through 29 | the [Developer Support portal](https://support-dev.discord.com/hc). -------------------------------------------------------------------------------- /docs/change-log/2025-04-21-discord-social-sdk-1.1.8318.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Discord Social SDK Release 1.1.8318" 3 | date: "2025-04-21" 4 | topics: 5 | - "Discord Social SDK" 6 | --- 7 | 8 | A new release of the Discord Social SDK is now available, with the following updates: 9 | 10 | ### Platforms 11 | - Playstation standalone archives now include linker stubs 12 | 13 | ### Voice 14 | - Fixed a regression in audio playback on Linux 15 | 16 | The Discord Social SDK binaries are available for download in the Developer Portal after enabling the Discord Social SDK 17 | for your application. 18 | 19 | To learn more about building with the Discord Social SDK, check out 20 | the [Discord Social SDK Overview](/docs/discord-social-sdk/overview). 21 | -------------------------------------------------------------------------------- /docs/change-log/2025-04-29-component-limits.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Raised Component Limits" 3 | date: "2025-04-29" 4 | topics: 5 | - "User Apps" 6 | - "HTTP API" 7 | - "Interactions" 8 | --- 9 | 10 | We're removing the top level component limit and raising the limit on number of components in a message to 40 when using the [`IS_COMPONENTS_V2` message flag](/docs/resources/message#message-object-message-flags)! We're also removing the limit on the number of components in a [Container Component](/docs/components/reference#container). Legacy messages have not changed and continue to allow up to 5 action rows. 11 | 12 | #### What's New 13 | 14 | - **Total components**: The limit for total components in a message has been increased to 40. 15 | - **Top-level components**: There is no longer a limit on top level components in a message (previously it was 10). 16 | - **[Container Component](/docs/components/reference#container)**: There is no longer a limit on the number of components in a Container Component (previously it was 10). 17 | 18 | #### Developer Resources 19 | 20 | - Check out our [Component Reference](/docs/components/reference) for detailed specifications on all available components. 21 | - Learn how to build rich message layouts with components with [Using Message Components](/docs/components/using-message-components). 22 | -------------------------------------------------------------------------------- /docs/change-log/2025-05-05-discord-social-sdk-1.2.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Discord Social SDK Release 1.2" 3 | date: "2025-05-05" 4 | topics: 5 | - "Discord Social SDK" 6 | --- 7 | 8 | A new release of the Discord Social SDK is now available, with the following updates: 9 | 10 | ### Rich Presence 11 | - Added support for adding custom buttons on activity cards via [`Activity::AddButton`] 12 | 13 | ### Packaging 14 | - Unity and Unreal plugin artifacts now contain just the additional files for console support so they can be extracted on top of the base plugin 15 | - Unity plugin is now packaged as a .zip that you should extract inside the Packages directory of your project to enable the above 16 | - Console archives now contain a small README with some console-specific documentation 17 | 18 | ### Misc 19 | - Added [`Client::OpenConnectedGamesSettingsInDiscord`] for deeplinking into Discord's settings for connected games, which provides players some control over who can DM them 20 | - Fixed a hang that could occur on Linux in [`Client::RegisterLaunchCommand`] and [`Client::RegisterLaunchSteamApplication`] 21 | - [`Client::RegisterLaunchCommand`] and [`Client::RegisterLaunchSteamApplication`] now work from inside the Steam Runtime on Linux 22 | - Fixed a crash on exit that could occur when there were pending callbacks in the queue 23 | 24 | 25 | [`Activity::AddButton`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Activity.html#aab07650fcff18565eb78a1e2df46627e 26 | [`Client::OpenConnectedGamesSettingsInDiscord`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a24f268f5eebe9919a3f774354eb577e0 27 | [`Client::RegisterLaunchCommand`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a024d7222931fdcb7d09c2b107642ecab 28 | [`Client::RegisterLaunchSteamApplication`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a45b2c791c5b06f77d457dacb53dfba40 -------------------------------------------------------------------------------- /docs/discord-social-sdk/design-guidelines/branding-guidelines.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_label: Branding Guidelines 3 | --- 4 | 5 | [Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Design Guidelines](/docs/discord-social-sdk/design-guidelines) > Branding Guidelines 6 | 7 | # Branding Guidelines 8 | 9 | ## Discord Logo 10 | 11 | Download the Discord word-mark assets [discord.com/branding](https://discord.com/branding). 12 | 13 | Please do not edit, change, distort, recolor, or reconfigure the Discord logo. 14 | 15 | ![Discord Logo](images/social-sdk/design-guidelines/Brand-02.png) 16 | 17 | ## Buttons 18 | 19 | There are four sets of button styles for this integration: Blurple, Light, Dark, and Flexible. 20 | 21 | #### Flexible 22 | 23 | The Flexible buttons are intended to be restyled to match the game's aesthetic (examples). Flexible buttons include the font of the text before the logo as well as the button colors. The Discord logo and its colors should not be altered. This set is for in-game connection points. 24 | 25 | #### Blurple / Light / Dark 26 | 27 | These pre-styled buttons leverage colors vetted by our Design Systems team to pass contrast ratios across different backgrounds. 28 | 29 | ![Brand Buttons](images/social-sdk/design-guidelines/Brand-03.png) 30 | 31 | ## Spacing 32 | 33 | Ensure that there is adequate spacing between button text and the Discord logo as well as the left/right edges of the button. 34 | 35 | When using the Flexible button styling, ensure that your typeface's baseline and x-height are aligned to the Discord logo. 36 | 37 | ![Brand Spacing](images/social-sdk/design-guidelines/Brand-04.png) 38 | 39 | ## Resources 40 | 41 | - [Discord branding guidelines](https://discord.com/branding) 42 | 43 | ## Change Log 44 | 45 | | Date | Changes | 46 | |----------------|-----------------| 47 | | March 17, 2025 | initial release | 48 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/design-guidelines/direct-messages.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_label: Direct Messages 3 | --- 4 | 5 | [Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Design Guidelines](/docs/discord-social-sdk/design-guidelines) > Direct Messages 6 | 7 | # Direct Messages 8 | 9 | 10 | ## Badge when online elsewhere 11 | 12 | The badging logic in direct-messages is consistent with the logic detailed in the [Unified Friends List](/docs/discord-social-sdk/design-guidelines/unified-friends-list) section. 13 | 14 | If the user is **online elsewhere** and is not in the game client, their usernames will include a **Discord badge**. Once they're online in the game-client, they will not retain the Discord badge. 15 | 16 | ![Badge when online elsewhere](images/social-sdk/design-guidelines/animated/DMs-02.gif) 17 | 18 | ## Message styling 19 | 20 | Style the Discord logo to match a player's username color. The logo should feel tied to a user's identity, not the message content. 21 | 22 | ![Message styling](images/social-sdk/design-guidelines/DMs-03.png) 23 | 24 | ## Unsupported rich media 25 | Regardless of whether a user has signed into Discord, unsupported rich media content should be paired with an **external link icon**. 26 | 27 | When content isn't clickable, don't show the icon. 28 | 29 | ![Unsupported rich media](images/social-sdk/design-guidelines/DMs-04.png) 30 | 31 | --- 32 | 33 | ## Resources 34 | 35 | - [Development Guide: Direct Messages](/docs/discord-social-sdk/development-guides/sending-direct-messages) 36 | 37 | ## Change Log 38 | 39 | | Date | Changes | 40 | |----------------|-----------------| 41 | | March 17, 2025 | initial release | 42 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/development-guides/joining-voice-chat.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_label: Joining Voice Chat 3 | --- 4 | import LimitedAccessCallout from '../partials/callouts/limited-access.mdx'; 5 | import PublicClient from '../partials/callouts/public-client.mdx'; 6 | import SupportCallout from '../partials/callouts/support.mdx'; 7 | 8 | [Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Development Guides](/docs/discord-social-sdk/development-guides) > {sidebar_label} 9 | 10 | # {sidebar_label} 11 | 12 | 13 | 14 | ## Overview 15 | 16 | Lobbies support voice chat, allowing players to communicate with each other while playing games. 17 | 18 | :::info 19 | We will add a **Joining Voice Chat** development guide after GDC. Stay tuned! There is a voice implementation in the Unity sample project that you can reference in the meantime. 20 | ::: 21 | 22 | --- 23 | 24 | ## Next Steps 25 | 26 | 27 | 28 | Combine Discord and game friends into a single list for easy management. 29 | 30 | 31 | Display game status and information to Discord friends. 32 | 33 | 34 | Allow players to invite friends to join their game session or party. 35 | 36 | 37 | 38 | 39 | 40 | --- 41 | 42 | ## Change Log 43 | 44 | | Date | Changes | 45 | |----------------|-----------------| 46 | | March 17, 2025 | initial release | 47 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/getting-started/partials/dylib-mac-error.mdx: -------------------------------------------------------------------------------- 1 | 2 | On Mac you may get the error "libdiscord_partner_sdk.dylib" Not Opened because Apple couldn't verify it. If this happens press **Done** on the popup. 3 | 4 | ![Error](images/social-sdk/getting-started/partials/error.png) 5 | 6 | You'll need to open your **System Settings > Privacy & Security** and scroll down to the **Security** section. It will tell you "libdiscord_partner_sdk.dylib" was blocked to protect your Mac. Press **Open Anyway** and try running again. 7 | 8 | ![Settings](images/social-sdk/getting-started/partials/settings-security.png) 9 | 10 | Now when you get the pop up you'll have the option to select **Open Anyway** and it will be able to use it successfully. 11 | 12 | ![Open](images/social-sdk/getting-started/partials/open-anyway.png) 13 | 14 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/partials/callouts/console-access.mdx: -------------------------------------------------------------------------------- 1 | :::info 2 | To use the Discord Social SDK in your console games, you will need to request middleware approval and be an approved developer for the target console. Check out [this article](https://support-dev.discord.com/hc/en-us/articles/30209074764183) to learn more. 3 | ::: 4 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/partials/callouts/limited-access.mdx: -------------------------------------------------------------------------------- 1 | :::preview 2 | This feature is currently available with [limited access](/docs/discord-social-sdk/core-concepts#limited-access-features). To apply for full access to closed beta features, or to reach out to Discord directly to discuss your game, please fill out [this form](https://discord.com/developers/social-sdk-closed-beta-access-request-form). 3 | ::: -------------------------------------------------------------------------------- /docs/discord-social-sdk/partials/callouts/public-client.mdx: -------------------------------------------------------------------------------- 1 | :::warn 2 | This method requires enabling **Public Client** for your app. Most games will not want to ship with this enabled. [Learn more](/docs/discord-social-sdk/core-concepts#oauth2-client-types) 3 | ::: -------------------------------------------------------------------------------- /docs/discord-social-sdk/partials/callouts/support.mdx: -------------------------------------------------------------------------------- 1 | Need help? Join the [Discord Developers Server](https://discord.gg/discord-developers) and share questions in the `#social-sdk-dev-help` channel for support from the community. 2 | -------------------------------------------------------------------------------- /docs/discord-social-sdk/social-sdk-reference.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_label: Social SDK Reference 3 | --- -------------------------------------------------------------------------------- /docs/rich-presence/using-with-the-discord-social-sdk.mdx: -------------------------------------------------------------------------------- 1 | --- 2 | sidebar_label: Using with the Discord Social SDK 3 | --- 4 | 5 | # Using Rich Presence with the Discord Social SDK 6 | 7 | 8 | When developing a game, the [Discord Social SDK](/docs/discord-social-sdk/overview) makes it easy to integrate Rich Presence to display details about what a user is up to inside of your game or social experience. 9 | 10 | :::info 11 | Not sure if you should be building with the Discord Social SDK? Read through [Choosing an SDK](/docs/rich-presence/overview#choosing-an-sdk) to understand your options when integrating Rich Presence with your app. 12 | ::: 13 | 14 | 15 | ## Understanding Rich Presence Data 16 | 17 | Before we dig in, it's helpful to understand what Rich Presence data you can set when updating a user's presence data. Let's just take a look at what we're working with: 18 | 19 | ![Graphical representation of the legend for rich presence details](images/rp-legend.png) 20 | 21 | :::info 22 | For tips on designing Rich Presence, take a look at the [Rich Presence best practices guide](/docs/rich-presence/best-practices). 23 | ::: 24 | 25 | ## Setting Rich Presence Data 26 | 27 | Check out our [Setting Rich Presence](/docs/discord-social-sdk/development-guides/setting-rich-presence) guide and our to learn how to set custom presence data for your players using the Discord Social SDK. 28 | 29 | - [Design Guidelines: Status & Rich Presence](/docs/discord-social-sdk/design-guidelines/status-rich-presence) 30 | 31 | ![Rich Presence](images/social-sdk/design-guidelines/StatusPresence-06.png) 32 | -------------------------------------------------------------------------------- /eslint.config.js: -------------------------------------------------------------------------------- 1 | import eslint from '@eslint/js'; 2 | import tseslint from 'typescript-eslint'; 3 | import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'; 4 | 5 | export default tseslint.config( 6 | eslint.configs.recommended, 7 | eslintPluginPrettierRecommended, 8 | ...tseslint.configs.recommended, 9 | { 10 | rules: { 11 | "prettier/prettier": "error", 12 | } 13 | }, 14 | ); 15 | -------------------------------------------------------------------------------- /index.js: -------------------------------------------------------------------------------- 1 | module.exports = {}; 2 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "discord-api-docs", 3 | "version": "1.1.1", 4 | "description": "Documentation for using Discord's API", 5 | "main": "index.js", 6 | "type": "module", 7 | "directories": { 8 | "doc": "docs" 9 | }, 10 | "engines": { 11 | "node": ">= 20.11.0" 12 | }, 13 | "repository": { 14 | "type": "git", 15 | "url": "git+https://github.com/discord/discord-api-docs.git" 16 | }, 17 | "author": "Discord Krew", 18 | "license": "MIT", 19 | "bugs": { 20 | "url": "https://github.com/discord/discord-api-docs/issues" 21 | }, 22 | "homepage": "https://github.com/discord/discord-api-docs#readme", 23 | "scripts": { 24 | "build": "tsc", 25 | "lint": "eslint tools", 26 | "lint:fix": "eslint tools --fix", 27 | "test:links": "tsx tools/checkLinks.ts", 28 | "test:build": "tsx tools/checkBuild.ts", 29 | "test:tables": "npx markdown-table-formatter \"docs/**/*.{md,mdx}\" --check", 30 | "fix:tables": "npx markdown-table-formatter \"docs/**/*.{md,mdx}\"", 31 | "decorate:docs": "node tools/doxygen/generate-social-sdk-mapping.js && node tools/doxygen/decorate-social-sdk-references.js" 32 | }, 33 | "devDependencies": { 34 | "@actions/core": "^1.10.1", 35 | "@eslint/js": "^9.2.0", 36 | "@mdx-js/mdx": "^3.0.1", 37 | "@mdx-js/react": "^3.0.1", 38 | "@types/js-yaml": "^4.0.9", 39 | "@types/node": "^20.12.12", 40 | "chalk": "^5.3.0", 41 | "eslint": "^9.2.0", 42 | "eslint-config-prettier": "^9.1.0", 43 | "eslint-plugin-prettier": "^5.1.3", 44 | "execa": "^9.5.2", 45 | "js-yaml": "^4.1.0", 46 | "markdown-table-formatter": "^1.6.0", 47 | "mdast-util-from-markdown": "^2.0.1", 48 | "mdast-util-to-markdown": "^2.1.0", 49 | "prettier": "^3.2.5", 50 | "remark": "^15.0.1", 51 | "tsx": "^4.10.2", 52 | "typescript": "^5.4.5", 53 | "typescript-eslint": "^8.0.0-alpha.12" 54 | }, 55 | "dependencies": { 56 | "xml2js": "^0.6.2" 57 | } 58 | } 59 | -------------------------------------------------------------------------------- /resources/discord-social-sdk/linked-channel-icon.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /static/images/API_center.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/API_center.gif -------------------------------------------------------------------------------- /static/images/activities-presence-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities-presence-example.png -------------------------------------------------------------------------------- /static/images/activities/activities-hero.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/activities-hero.png -------------------------------------------------------------------------------- /static/images/activities/activity-instance-validation.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/activity-instance-validation.jpg -------------------------------------------------------------------------------- /static/images/activities/application-test-mode-prod.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/application-test-mode-prod.gif -------------------------------------------------------------------------------- /static/images/activities/bobble-bash.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/bobble-bash.png -------------------------------------------------------------------------------- /static/images/activities/bobble-league.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/bobble-league.png -------------------------------------------------------------------------------- /static/images/activities/chess-victory.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/chess-victory.png -------------------------------------------------------------------------------- /static/images/activities/custom-link-embed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/custom-link-embed.png -------------------------------------------------------------------------------- /static/images/activities/debug-logs-filtering.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/debug-logs-filtering.gif -------------------------------------------------------------------------------- /static/images/activities/default_orientation_lock_state.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/default_orientation_lock_state.png -------------------------------------------------------------------------------- /static/images/activities/developer-mode.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/developer-mode.gif -------------------------------------------------------------------------------- /static/images/activities/discord-activities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/discord-activities.png -------------------------------------------------------------------------------- /static/images/activities/eights.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/eights.png -------------------------------------------------------------------------------- /static/images/activities/enable-activities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/enable-activities.png -------------------------------------------------------------------------------- /static/images/activities/encourage-hardware-acceleration-modal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/encourage-hardware-acceleration-modal.png -------------------------------------------------------------------------------- /static/images/activities/external-link-modal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/external-link-modal.png -------------------------------------------------------------------------------- /static/images/activities/invite-dialog.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/invite-dialog.png -------------------------------------------------------------------------------- /static/images/activities/join-application.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/join-application.png -------------------------------------------------------------------------------- /static/images/activities/new-app.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/new-app.png -------------------------------------------------------------------------------- /static/images/activities/oauth2-details.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/oauth2-details.png -------------------------------------------------------------------------------- /static/images/activities/oauth2-redirect.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/oauth2-redirect.png -------------------------------------------------------------------------------- /static/images/activities/share-moment-dialog-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/share-moment-dialog-example.png -------------------------------------------------------------------------------- /static/images/activities/start-activity.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/start-activity.png -------------------------------------------------------------------------------- /static/images/activities/supported-platforms.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/supported-platforms.png -------------------------------------------------------------------------------- /static/images/activities/tutorial-auth.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/tutorial-auth.png -------------------------------------------------------------------------------- /static/images/activities/tutorial-channel-name.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/tutorial-channel-name.png -------------------------------------------------------------------------------- /static/images/activities/tutorial-hero.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/tutorial-hero.png -------------------------------------------------------------------------------- /static/images/activities/tutorial-launched.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/tutorial-launched.png -------------------------------------------------------------------------------- /static/images/activities/url-mapping-do.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/url-mapping-do.png -------------------------------------------------------------------------------- /static/images/activities/url-mapping-dont.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/url-mapping-dont.png -------------------------------------------------------------------------------- /static/images/activities/url-mapping-tutorial.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/activities/url-mapping-tutorial.png -------------------------------------------------------------------------------- /static/images/alerts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/alerts.png -------------------------------------------------------------------------------- /static/images/annotated-presence-data-activities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/annotated-presence-data-activities.png -------------------------------------------------------------------------------- /static/images/app-add-bot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/app-add-bot.png -------------------------------------------------------------------------------- /static/images/app-create-modal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/app-create-modal.png -------------------------------------------------------------------------------- /static/images/ask-to-join.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/ask-to-join.gif -------------------------------------------------------------------------------- /static/images/available-published.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/available-published.png -------------------------------------------------------------------------------- /static/images/botuser-profile.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/botuser-profile.png -------------------------------------------------------------------------------- /static/images/bp-productpage-app-description.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/bp-productpage-app-description.png -------------------------------------------------------------------------------- /static/images/bp-productpage-summary-bad.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/bp-productpage-summary-bad.png -------------------------------------------------------------------------------- /static/images/bp-productpage-summary-good.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/bp-productpage-summary-good.png -------------------------------------------------------------------------------- /static/images/bp-productpage-tags.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/bp-productpage-tags.png -------------------------------------------------------------------------------- /static/images/button-styles.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/button-styles.png -------------------------------------------------------------------------------- /static/images/certified-device.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/certified-device.png -------------------------------------------------------------------------------- /static/images/cloudflare-general-overview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cloudflare-general-overview.png -------------------------------------------------------------------------------- /static/images/cloudflare-interactions-endpoint.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cloudflare-interactions-endpoint.png -------------------------------------------------------------------------------- /static/images/cloudflare-ngrok.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cloudflare-ngrok.png -------------------------------------------------------------------------------- /static/images/cloudflare-tutorial-demo.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cloudflare-tutorial-demo.gif -------------------------------------------------------------------------------- /static/images/cloudflare-url-generator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cloudflare-url-generator.png -------------------------------------------------------------------------------- /static/images/command-entry-point.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/command-entry-point.png -------------------------------------------------------------------------------- /static/images/command-types.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/command-types.png -------------------------------------------------------------------------------- /static/images/command-with-groups-subcommands-parameters.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/command-with-groups-subcommands-parameters.png -------------------------------------------------------------------------------- /static/images/command-with-groups-subcommands.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/command-with-groups-subcommands.png -------------------------------------------------------------------------------- /static/images/command.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/command.png -------------------------------------------------------------------------------- /static/images/components/action-row.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/action-row.png -------------------------------------------------------------------------------- /static/images/components/channel-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/channel-select.png -------------------------------------------------------------------------------- /static/images/components/container.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/container.png -------------------------------------------------------------------------------- /static/images/components/file.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/file.png -------------------------------------------------------------------------------- /static/images/components/hero.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/hero.png -------------------------------------------------------------------------------- /static/images/components/media-gallery.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/media-gallery.png -------------------------------------------------------------------------------- /static/images/components/mentionable-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/mentionable-select.png -------------------------------------------------------------------------------- /static/images/components/modal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/modal.png -------------------------------------------------------------------------------- /static/images/components/role-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/role-select.png -------------------------------------------------------------------------------- /static/images/components/section.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/section.png -------------------------------------------------------------------------------- /static/images/components/separator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/separator.png -------------------------------------------------------------------------------- /static/images/components/string-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/string-select.png -------------------------------------------------------------------------------- /static/images/components/text-display.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/text-display.png -------------------------------------------------------------------------------- /static/images/components/user-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/components/user-select.png -------------------------------------------------------------------------------- /static/images/cpp-files-sdk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/cpp-files-sdk.png -------------------------------------------------------------------------------- /static/images/create-store-channel.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/create-store-channel.png -------------------------------------------------------------------------------- /static/images/create-team-owned-app.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/create-team-owned-app.png -------------------------------------------------------------------------------- /static/images/default-presence-activities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/default-presence-activities.png -------------------------------------------------------------------------------- /static/images/deferred-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/deferred-example.png -------------------------------------------------------------------------------- /static/images/desktop-role-select-menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/desktop-role-select-menu.png -------------------------------------------------------------------------------- /static/images/desktop-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/desktop-select.png -------------------------------------------------------------------------------- /static/images/discovery-app-directory-product-page.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/discovery-app-directory-product-page.png -------------------------------------------------------------------------------- /static/images/discovery-app-launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/discovery-app-launcher.png -------------------------------------------------------------------------------- /static/images/discovery-sharing-links.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/discovery-sharing-links.png -------------------------------------------------------------------------------- /static/images/example-poll.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/example-poll.png -------------------------------------------------------------------------------- /static/images/examples-ephemeral-message.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/examples-ephemeral-message.png -------------------------------------------------------------------------------- /static/images/examples-message-reactive.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/examples-message-reactive.png -------------------------------------------------------------------------------- /static/images/examples-update-message.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/examples-update-message.png -------------------------------------------------------------------------------- /static/images/game-overlay-sdk-invite.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/game-overlay-sdk-invite.gif -------------------------------------------------------------------------------- /static/images/game-overlay-sdk-voice-settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/game-overlay-sdk-voice-settings.png -------------------------------------------------------------------------------- /static/images/game-overlay-sdk-voice-widget.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/game-overlay-sdk-voice-widget.png -------------------------------------------------------------------------------- /static/images/game-sdk-presence-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/game-sdk-presence-example.png -------------------------------------------------------------------------------- /static/images/getting-started-default-install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/getting-started-default-install.png -------------------------------------------------------------------------------- /static/images/getting-started-demo.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/getting-started-demo.gif -------------------------------------------------------------------------------- /static/images/getting-started-interactions-endpoint.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/getting-started-interactions-endpoint.png -------------------------------------------------------------------------------- /static/images/gift-code-creation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/gift-code-creation.png -------------------------------------------------------------------------------- /static/images/glitch-project.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/glitch-project.png -------------------------------------------------------------------------------- /static/images/heroku-baking.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-baking.gif -------------------------------------------------------------------------------- /static/images/heroku-buildpack.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-buildpack.png -------------------------------------------------------------------------------- /static/images/heroku-configVars.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-configVars.png -------------------------------------------------------------------------------- /static/images/heroku-connectGH.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-connectGH.png -------------------------------------------------------------------------------- /static/images/heroku-deploy.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-deploy.png -------------------------------------------------------------------------------- /static/images/heroku-dynos.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-dynos.png -------------------------------------------------------------------------------- /static/images/heroku-login.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-login.png -------------------------------------------------------------------------------- /static/images/heroku-logs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-logs.png -------------------------------------------------------------------------------- /static/images/heroku-procfile.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-procfile.png -------------------------------------------------------------------------------- /static/images/heroku-token.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/heroku-token.png -------------------------------------------------------------------------------- /static/images/interactions-url.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/interactions-url.png -------------------------------------------------------------------------------- /static/images/lib-linked-sdk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/lib-linked-sdk.png -------------------------------------------------------------------------------- /static/images/linked-roles-connect-account.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-connect-account.png -------------------------------------------------------------------------------- /static/images/linked-roles-connected.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-connected.png -------------------------------------------------------------------------------- /static/images/linked-roles-consent-dialog.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-consent-dialog.png -------------------------------------------------------------------------------- /static/images/linked-roles-glitch-share-url.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-glitch-share-url.png -------------------------------------------------------------------------------- /static/images/linked-roles-glitch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-glitch.png -------------------------------------------------------------------------------- /static/images/linked-roles-oauth-config.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-oauth-config.png -------------------------------------------------------------------------------- /static/images/linked-roles-register.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-register.png -------------------------------------------------------------------------------- /static/images/linked-roles-verification-setup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-verification-setup.png -------------------------------------------------------------------------------- /static/images/linked-roles-verify-endpoint.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/linked-roles-verify-endpoint.png -------------------------------------------------------------------------------- /static/images/mdx-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/mdx-button.png -------------------------------------------------------------------------------- /static/images/mdx-card.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/mdx-card.png -------------------------------------------------------------------------------- /static/images/mdx-collapsible.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/mdx-collapsible.png -------------------------------------------------------------------------------- /static/images/message-command.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/message-command.png -------------------------------------------------------------------------------- /static/images/mobile-select.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/mobile-select.png -------------------------------------------------------------------------------- /static/images/modal-desktop.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/modal-desktop.png -------------------------------------------------------------------------------- /static/images/monetization-eligibility.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/monetization-eligibility.png -------------------------------------------------------------------------------- /static/images/monetization-interaction-response.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/monetization-interaction-response.png -------------------------------------------------------------------------------- /static/images/monetization-overview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/monetization-overview.png -------------------------------------------------------------------------------- /static/images/monetization.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/monetization.png -------------------------------------------------------------------------------- /static/images/multiple-buttons-example-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/multiple-buttons-example-1.png -------------------------------------------------------------------------------- /static/images/multiple-buttons-example-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/multiple-buttons-example-2.png -------------------------------------------------------------------------------- /static/images/multisub.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/multisub.png -------------------------------------------------------------------------------- /static/images/overview-command-desktop.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/overview-command-desktop.png -------------------------------------------------------------------------------- /static/images/overview-components.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/overview-components.png -------------------------------------------------------------------------------- /static/images/overview-modals.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/overview-modals.png -------------------------------------------------------------------------------- /static/images/overview-of-apps-banner.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/overview-of-apps-banner.png -------------------------------------------------------------------------------- /static/images/premium-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/premium-button.png -------------------------------------------------------------------------------- /static/images/premium-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/premium-example.png -------------------------------------------------------------------------------- /static/images/premium-items.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/premium-items.png -------------------------------------------------------------------------------- /static/images/premium-subscriptions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/premium-subscriptions.png -------------------------------------------------------------------------------- /static/images/previous-new-server-background.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/previous-new-server-background.png -------------------------------------------------------------------------------- /static/images/rich-presence-asset-images.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rich-presence-asset-images.png -------------------------------------------------------------------------------- /static/images/rich-presence-examples.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rich-presence-examples.png -------------------------------------------------------------------------------- /static/images/rich-presence-invite-image.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rich-presence-invite-image.png -------------------------------------------------------------------------------- /static/images/rp-actionable.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-actionable.png -------------------------------------------------------------------------------- /static/images/rp-all-fields.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-all-fields.png -------------------------------------------------------------------------------- /static/images/rp-good-art.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-good-art.png -------------------------------------------------------------------------------- /static/images/rp-legend.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-legend.png -------------------------------------------------------------------------------- /static/images/rp-profile-example-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-profile-example-1.png -------------------------------------------------------------------------------- /static/images/rp-profile-example-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-profile-example-2.png -------------------------------------------------------------------------------- /static/images/rp-short-strings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/rp-short-strings.png -------------------------------------------------------------------------------- /static/images/server-banner-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/server-banner-example.png -------------------------------------------------------------------------------- /static/images/server-banner-margin-top.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/server-banner-margin-top.png -------------------------------------------------------------------------------- /static/images/sku-benefits.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-benefits.png -------------------------------------------------------------------------------- /static/images/sku-configure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-configure.png -------------------------------------------------------------------------------- /static/images/sku-custom.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-custom.png -------------------------------------------------------------------------------- /static/images/sku-customization.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-customization.png -------------------------------------------------------------------------------- /static/images/sku-management.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-management.png -------------------------------------------------------------------------------- /static/images/sku-publish.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-publish.png -------------------------------------------------------------------------------- /static/images/sku-unicode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku-unicode.png -------------------------------------------------------------------------------- /static/images/sku_embed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/sku_embed.png -------------------------------------------------------------------------------- /static/images/slash-command-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/slash-command-options.png -------------------------------------------------------------------------------- /static/images/snowflake.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/snowflake.png -------------------------------------------------------------------------------- /static/images/snowflake_original_size.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/snowflake_original_size.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Brand-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Brand-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Brand-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Brand-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Brand-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Brand-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/ConnectionPoints-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/ConnectionPoints-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/ConnectionPoints-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/ConnectionPoints-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/ConnectionPoints-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/ConnectionPoints-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/ConnectionPoints-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/ConnectionPoints-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-01.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-01.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-02.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-02.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-03.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-03.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-04.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-04.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-05.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-05.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Consoles-06.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Consoles-06.jpg -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/DMs-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/DMs-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/DMs-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/DMs-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/DMs-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/DMs-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-01.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-01.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-07.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-07.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-08.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-08.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-09.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-09.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/GameFriends-10.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/GameFriends-10.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/LinkedChannels-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/LinkedChannels-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/LinkedChannels-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/LinkedChannels-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/LinkedChannels-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/LinkedChannels-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/LinkedChannels-07.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/LinkedChannels-07.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Principle-07.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Principle-07.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Prov-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Prov-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Prov-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Prov-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Prov-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Prov-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/Prov-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/Prov-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-07.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-07.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SigningIn-08.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SigningIn-08.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SocialSettings-02.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SocialSettings-02.webp -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SocialSettings-03.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SocialSettings-03.webp -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/SocialSettings-04.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/SocialSettings-04.webp -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/StatusPresence-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/StatusPresence-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/StatusPresence-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/StatusPresence-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/StatusPresence-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/StatusPresence-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/StatusPresence-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/StatusPresence-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/StatusPresence-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/StatusPresence-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-02.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-03.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-03.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-04.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-04.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-05.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-05.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-06.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-06.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-07.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-07.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/UFL-08.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/UFL-08.png -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/Connecting-via-Browser.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/Connecting-via-Browser.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/Connecting-via-Client.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/Connecting-via-Client.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/DMs-02.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/DMs-02.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/LinkedChannel-Setup.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/LinkedChannel-Setup.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/LinkedChannel-Unlink.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/LinkedChannel-Unlink.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/LinkedChannels-02.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/LinkedChannels-02.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/LinkedChannels-08.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/LinkedChannels-08.gif -------------------------------------------------------------------------------- /static/images/social-sdk/design-guidelines/animated/UFL-06.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/design-guidelines/animated/UFL-06.gif -------------------------------------------------------------------------------- /static/images/social-sdk/development-guides/authorize_device.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/development-guides/authorize_device.png -------------------------------------------------------------------------------- /static/images/social-sdk/development-guides/discord-game-dm-settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/development-guides/discord-game-dm-settings.png -------------------------------------------------------------------------------- /static/images/social-sdk/getting-started/partials/error.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/getting-started/partials/error.png -------------------------------------------------------------------------------- /static/images/social-sdk/getting-started/partials/open-anyway.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/getting-started/partials/open-anyway.png -------------------------------------------------------------------------------- /static/images/social-sdk/getting-started/partials/settings-security.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/getting-started/partials/settings-security.png -------------------------------------------------------------------------------- /static/images/social-sdk/overview/social_sdk_header.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/social-sdk/overview/social_sdk_header.png -------------------------------------------------------------------------------- /static/images/spectate.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/spectate.gif -------------------------------------------------------------------------------- /static/images/store_embed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/store_embed.png -------------------------------------------------------------------------------- /static/images/team-page.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/team-page.png -------------------------------------------------------------------------------- /static/images/transfer-app-to-team.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/transfer-app-to-team.png -------------------------------------------------------------------------------- /static/images/url-generator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/url-generator.png -------------------------------------------------------------------------------- /static/images/user-command.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/user-command.png -------------------------------------------------------------------------------- /static/images/user-install-game-message.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/user-install-game-message.png -------------------------------------------------------------------------------- /static/images/user-install-settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/discord/discord-api-docs/e98dc34c4582c5e2d44600ad4aef466137b2a22a/static/images/user-install-settings.png -------------------------------------------------------------------------------- /tools/checkBuild.ts: -------------------------------------------------------------------------------- 1 | import fs from "node:fs/promises"; 2 | import path from "node:path"; 3 | import { compile } from "@mdx-js/mdx"; 4 | 5 | const args = process.argv.slice(2); 6 | const bail = args.includes("--bail"); 7 | 8 | const ROOT_DIR = path.join(import.meta.dirname, ".."); 9 | const DOCS_DIR = path.join(ROOT_DIR, "docs"); 10 | 11 | const extensions = [".mdx", ".md"]; 12 | let hasErrors = false; 13 | 14 | for (const docsRelativePath of await fs.readdir(DOCS_DIR, { recursive: true })) { 15 | const filePath = path.join(DOCS_DIR, docsRelativePath); 16 | const rootRelPath = path.relative(ROOT_DIR, filePath); 17 | 18 | if (extensions.includes(path.extname(filePath))) { 19 | try { 20 | console.error(`Compiling ${rootRelPath}`); 21 | await compile(await fs.readFile(filePath), { 22 | format: path.extname(filePath) === ".mdx" ? "mdx" : "md", 23 | }); 24 | } catch (error) { 25 | console.error(`Error compiling ${rootRelPath}:`); 26 | console.error(error); 27 | hasErrors = true; 28 | if (bail) { 29 | process.exit(1); 30 | } 31 | } 32 | } 33 | } 34 | 35 | if (hasErrors) { 36 | process.exit(1); 37 | } 38 | -------------------------------------------------------------------------------- /tools/rename-files.js: -------------------------------------------------------------------------------- 1 | import { $ } from "execa"; 2 | import fs from "fs/promises"; 3 | import path from "path"; 4 | 5 | async function renameFilesInDirectory(directory) { 6 | const files = await fs.readdir(directory, { withFileTypes: true }); 7 | 8 | for (const file of files) { 9 | const fullPath = path.join(directory, file.name); 10 | 11 | if (file.isDirectory()) { 12 | await renameFilesInDirectory(fullPath); 13 | } else { 14 | const newFileName = file.name.toLowerCase().replace(/_/g, "-"); 15 | 16 | if (newFileName !== file.name) { 17 | const newFullPath = path.join(directory, newFileName); 18 | await $`git mv ${fullPath} ${newFullPath}`; 19 | } 20 | } 21 | } 22 | } 23 | 24 | await renameFilesInDirectory("docs"); 25 | -------------------------------------------------------------------------------- /tsconfig.json: -------------------------------------------------------------------------------- 1 | { 2 | "compilerOptions": { 3 | "noEmit": true, 4 | "target": "ES2022", 5 | "strict": true, 6 | "esModuleInterop": true, 7 | "rootDir": "./", 8 | "module": "NodeNext", 9 | "outDir": "./dist" 10 | }, 11 | "include": ["**/*.ts"], 12 | } 13 | --------------------------------------------------------------------------------