generated: '2026-07-11'
method: derived
source: openapi/discord-openapi-original.yml, openapi/discord-rest-api-openapi.yml
schemes:
- name: OAuth2
  source: openapi/discord-openapi-original.yml
  flows:
  - flow: implicit
    authorizationUrl: discord.com/oauth2/authorize
  - flow: clientCredentials
    tokenUrl: https://discord.com/api/oauth2/token
  - flow: authorizationCode
    authorizationUrl: discord.com/oauth2/authorize
    tokenUrl: https://discord.com/api/oauth2/token
- name: OAuth2
  source: openapi/discord-rest-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://discord.com/oauth2/authorize
    tokenUrl: https://discord.com/api/v10/oauth2/token
scopes:
- scope: activities.read
  description: allows your app to fetch data from a user's "Now Playing/Recently Played" list
    - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: activities.write
  description: allows your app to update a user's activity - requires Discord approval (NOT
    REQUIRED FOR GAMESDK ACTIVITY MANAGER)
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.builds.read
  description: allows your app to read build data for a user's applications
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.builds.upload
  description: allows your app to upload/update builds for a user's applications - requires
    Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.commands
  description: allows your app to use commands in a guild
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: applications.commands.permissions.update
  description: allows your app to update permissions for its commands in a guild a user has
    permissions to
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.commands.update
  description: allows your app to update its commands using a Bearer token - client credentials
    grant only
  flows:
  - clientCredentials
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.entitlements
  description: allows your app to read entitlements for a user's applications
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: applications.store.update
  description: allows your app to read and update store data (SKUs, store listings, achievements,
    etc.) for a user's applications
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: bot
  description: for oauth2 bots, this puts the bot in the user's selected guild by default
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: connections
  description: allows /users/@me/connections to return linked third-party accounts
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: dm_channels.read
  description: allows your app to see information about the user's DMs and group DMs - requires
    Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: email
  description: enables /users/@me to return an email
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: gdm.join
  description: allows your app to join users to a group dm
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: guilds
  description: allows /users/@me/guilds to return basic information about all of a user's guilds
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: guilds.join
  description: allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a
    guild
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: guilds.members.read
  description: allows /users/@me/guilds/{guild.id}/member to return a user's member information
    in a guild
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: identify
  description: allows /users/@me without email
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: messages.read
  description: for local rpc server api access, this allows you to read messages from all client
    channels (otherwise restricted to channels/guilds your app creates)
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
  - openapi/discord-rest-api-openapi.yml
- scope: openid
  description: for OpenID Connect, this allows your app to receive user id and basic profile
    information
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: relationships.read
  description: allows your app to know a user's friends and implicit relationships - requires
    Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: role_connections.write
  description: allows your app to update a user's connection and metadata for the app
  flows:
  - authorizationCode
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc
  description: for local rpc server access, this allows you to control a user's local Discord
    client - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.activities.write
  description: for local rpc server access, this allows you to update a user's activity - requires
    Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.notifications.read
  description: for local rpc server access, this allows you to receive notifications pushed
    out to the user - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.screenshare.read
  description: for local rpc server access, this allows you to read a user's screenshare status-
    requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.screenshare.write
  description: for local rpc server access, this allows you to update a user's screenshare settings-
    requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.video.read
  description: for local rpc server access, this allows you to read a user's video status -
    requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.video.write
  description: for local rpc server access, this allows you to update a user's video settings
    - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.voice.read
  description: for local rpc server access, this allows you to read a user's voice settings
    and listen for voice events - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: rpc.voice.write
  description: for local rpc server access, this allows you to update a user's voice settings
    - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: voice
  description: allows your app to connect to voice on user's behalf and see all the voice members
    - requires Discord approval
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml
- scope: webhook.incoming
  description: this generates a webhook that is returned in the oauth token response for authorization
    code grants
  flows:
  - authorizationCode
  - clientCredentials
  - implicit
  sources:
  - openapi/discord-openapi-original.yml