ReferenceScopes
api:write
Example custom scope, write access.
OAuth2 scope: api:write
Source: Per-app
Description
Example custom scope, write access.
Requesting this scope
In the authorization URL:
GET /oauth2/auth?
&scope=api:write
...Multiple scopes are space-separated.
Granting access
A client only receives this scope if it's on the client's allowed scope list. Configure in Athena → OAuth2 Clients → your client → Allowed Scopes.
Checking in your backend
The access token's scope claim contains the granted scopes:
const granted = info.scope?.split(" ") ?? [];
if (!granted.includes("api:write")) return 403;