Permissions
Each token should have one associated permission and one or more scopes to be usable.
The permissions and scopes assigned to a token cannot be changed after the token is created. Carefully select these attributes during token creation.
User Tokens
These tokens can make API calls on behalf of a particular user. The user email is fixed while creating the token. The X-Scio-ActAs
HTTP header must be empty.
Global Tokens
These tokens can make API calls on behalf of any user in the system. To identify the user for each API call, the X-Scio-ActAs
HTTP header must be included, specifying the user’s email address.
Tokens with GLOBAL
permissions can only be created by Super Admin users.
Anonymous Tokens
These tokens can make API calls on behalf of an anonymous user. The X-Scio-ActAs
HTTP header must be empty.
ANONYMOUS
permissions are supported only for a few endpoints as of now. Please contact Glean support if you’re interested to use such tokens.
Scopes
Scopes define the endpoints that are available to a token. When you create a token, you will select the permission and scope(s) in the “Add Client API Token” dialogue box as described in the token creation steps.
A client API token can have one or more of the following scopes:
Scope | Description |
---|---|
ACTIVITY | Can access datasource user activity collection endpoints. |
ANNOUNCEMENTS | Can access Glean Announcements related endpoints. |
ANSWERS | Can access Glean Answers related endpoints. |
CHAT | Can access GleanChat related endpoints. |
COLLECTIONS | Can access Glean Collections related endpoints. |
DOC_PERMISSIONS | Can access the Glean Document Permissions related endpoints. |
DOCUMENTS | Can access endpoints related to Glean documents. |
ENTITIES | Can access endpoints related to entities. |
FEED | Can access Glean Feed related endpoints. |
FEEDBACK | Can access user feedback related endpoints. |
INSIGHTS | Can access insights related endpoints. |
PEOPLE | Can access Glean people related endpoints. |
PINS | Can access Glean pins related endpoints. |
SEARCH | Can access endpoints related to search queries and autocomplete. |
SHORTCUTS | Can access shortcuts feature (aka GoLinks) related endpoints. |
SUMMARIZE | Can access AI summary related endpoints. |
VERIFICATION | Can access endpoints related to document verification feature. |
Was this page helpful?