Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Separate OAuth2 Scopes table #5130

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

advaith1
Copy link
Contributor

This PR addresses some issues with the OAuth2 Scopes table by separating it into multiple groups:

  • Public User Scopes (normal)
  • Guild Scopes (commands/bot)
  • Other Scopes (webhooks/client creds)
  • Restricted Scopes (devs/testers only, unless approved)
  • Private Scopes (approval required)

I think this is a better alternative to the controversial #5127, as it should resolve confusion without removing documentation. I believe the documentation should continue to list all scopes, as it can be useful.

View updated section

@advaith1 advaith1 changed the title Separate OAuth2 Scopes tabke Separate OAuth2 Scopes table Jun 29, 2022
@AlmostSuspense
Copy link
Contributor

perhaps there should be a section about what "approval" is, to avoid more confusion from users since i believe there's no formal approval process?

docs/topics/OAuth2.md Outdated Show resolved Hide resolved
@Mehgugs
Copy link
Contributor

Mehgugs commented Jun 29, 2022

What does "applications.store.update" actually authorize, I cannot find an endpoint that the token can use: are you sure that is not behind approval?

@advaith1
Copy link
Contributor Author

perhaps there should be a section about what "approval" is, to avoid more confusion from users since i believe there's no formal approval process?

tried to clarify this with

Some scopes require approval from Discord to use, and there is no public application process.

could add more information tho


What does "applications.store.update" actually authorize, I cannot find an endpoint that the token can use: are you sure that is not behind approval?

yeah this scope does not require approval; this allows reading and managing store & achievement data for the user's apps with dev licenses, achievement endpoints are documented at https://discord.com/developers/docs/game-sdk/achievements#the-api-way

maybe I should add a link to that in the scopes table

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants