Skip to main content

OAuth2Scope

@discordeno/botDocs


Documentation / @discordeno/bot / OAuth2Scope

Enumeration: OAuth2Scope

https://discord.com/developers/docs/topics/oauth2#shared-resources-oauth2-scopes

Enumeration Members

ActivitiesRead

ActivitiesRead: "activities.read"

Allows your app to fetch data from a user's "Now Playing/Recently Played" list

Remarks

This scope is not currently available for apps

Defined in

packages/types/dist/types/discord.d.ts:47


ActivitiesWrite

ActivitiesWrite: "activities.write"

Allows your app to update a user's activity

Remarks

This scope not currently available for apps.

Defined in

packages/types/dist/types/discord.d.ts:54


ApplicationCommandsPermissionsUpdate

ApplicationCommandsPermissionsUpdate: "applications.commands.permissions.update"

Allows your app to update permissions for its commands in a guild a user has permissions to

Defined in

packages/types/dist/types/discord.d.ts:74


ApplicationsBuildsRead

ApplicationsBuildsRead: "applications.builds.read"

Allows your app to read build data for a user's applications

Defined in

packages/types/dist/types/discord.d.ts:56


ApplicationsBuildsUpload

ApplicationsBuildsUpload: "applications.builds.upload"

Allows your app to upload/update builds for a user's applications

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:63


ApplicationsCommands

ApplicationsCommands: "applications.commands"

Allows your app to add commands to a guild - included by default with the bot scope

Defined in

packages/types/dist/types/discord.d.ts:65


ApplicationsCommandsUpdate

ApplicationsCommandsUpdate: "applications.commands.update"

Allows your app to update its Application Commands via this bearer token

Remarks

This scope can only be used when using a Client Credential Grant

Defined in

packages/types/dist/types/discord.d.ts:72


ApplicationsEntitlements

ApplicationsEntitlements: "applications.entitlements"

Allows your app to read entitlements for a user's applications

Defined in

packages/types/dist/types/discord.d.ts:76


ApplicationsStoreUpdate

ApplicationsStoreUpdate: "applications.store.update"

Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications

Defined in

packages/types/dist/types/discord.d.ts:78


Bot

Bot: "bot"

For oauth2 bots, this puts the bot in the user's selected guild by default

Defined in

packages/types/dist/types/discord.d.ts:80


Connections

Connections: "connections"

Allows requests to /users/@me/connections

Defined in

packages/types/dist/types/discord.d.ts:82


DMChannelsRead

DMChannelsRead: "dm_channels.read"

Allows your app to see information about the user's DMs and group DMs

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:89


Email

Email: "email"

Adds the email filed to /users/@me

Defined in

packages/types/dist/types/discord.d.ts:91


GroupDMJoins

GroupDMJoins: "gdm.join"

Allows your app to join users to a group dm

Defined in

packages/types/dist/types/discord.d.ts:93


Guilds

Guilds: "guilds"

Allows requests to /users/@me/guilds

Defined in

packages/types/dist/types/discord.d.ts:95


GuildsJoin

GuildsJoin: "guilds.join"

Allows requests to /guilds/{guild.id}/members/{user.id}

Defined in

packages/types/dist/types/discord.d.ts:97


GuildsMembersRead

GuildsMembersRead: "guilds.members.read"

Allows requests to /users/@me/guilds/{guild.id}/member

Defined in

packages/types/dist/types/discord.d.ts:99


Identify

Identify: "identify"

Allows requests to /users/@me

Remarks

The return object from /users/@me does NOT contain the email field unless the scope email is also used

Defined in

packages/types/dist/types/discord.d.ts:107


MessagesRead

MessagesRead: "messages.read"

For local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates)

Defined in

packages/types/dist/types/discord.d.ts:112


RelationshipsRead

RelationshipsRead: "relationships.read"

Allows your app to know a user's friends and implicit relationships

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:119


RoleConnectionsWrite

RoleConnectionsWrite: "role_connections.write"

Allows your app to update a user's connection and metadata for the app

Defined in

packages/types/dist/types/discord.d.ts:121


RPC

RPC: "rpc"

For local rpc server access, this allows you to control a user's local Discord client

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:128


RPCActivitiesWrite

RPCActivitiesWrite: "rpc.activities.write"

For local rpc server access, this allows you to update a user's activity

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:135


RPCNotificationsRead

RPCNotificationsRead: "rpc.notifications.read"

For local rpc server api access, this allows you to receive notifications pushed out to the user

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:142


RPCVoiceRead

RPCVoiceRead: "rpc.voice.read"

For local rpc server access, this allows you to read a user's voice settings and listen for voice events

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:149


RPCVoiceWrite

RPCVoiceWrite: "rpc.voice.write"

For local rpc server access, this allows you to update a user's voice settings

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:156


Voice

Voice: "voice"

Allows your app to connect to voice on user's behalf and see all the voice members

Remarks

This scope requires Discord approval to be used

Defined in

packages/types/dist/types/discord.d.ts:163


WebhookIncoming

WebhookIncoming: "webhook.incoming"

Generate a webhook that is returned in the oauth token response for authorization code grants

Defined in

packages/types/dist/types/discord.d.ts:165