Get users doesn't mention that an App Access Token works
Mentions User OAuth and the optional scope, but doesn't mention that you can use an app access token for this endpoint to get "public" data.
Authentication User OAuth Token Optional scope: user:read:email If this scope is provided, the response includes the user’s email address.
Should probably read
Authentication - App Access Token - User OAuth Token any/no scopes - User OAuth Token with scope: user:read:email response includes the user’s email address.
Upvoted this! I've literally just faced the confusement due to lack of information attaining to the fact you can use App Access Tokens. This just got forwarded to me after a post on the forums.
The documentation definitely needs revised to what has been recommended or similiar to that.
Additionally the documentation currently states
OAuth token required
Required scope: user:read:email
Leading to confusion