API Tokens

Understand the difference between User and Collection tokens

There are two types of API Tokens: User Tokens and Collection Tokens.

  • User tokens have read and write permissions.
  • Collection tokens only have read permissions as they're specific to a single Collection within your Guru instance.

Learn more below to understand which API credential type is best suited for your project needs.

User TokenCollection Token
Permissions Read/WriteRead-Only
Authorization User-levelCollection-level
Requests GET
Results Results are returned based on the level of authorization associated with the User whose token you are usingResults of GET requests will only return results from the Collection associated with your token

Note: when using a collection token, you will first need to get the collection ID
This can be done using a User token to get all collections on your team.