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 Token | Collection Token | |
|---|---|---|
Permissions | Read/Write | Read-Only |
Authorization | User-level | Collection-level |
Requests | GET | GET |
Results | Results are returned based on the level of authorization associated with the User whose token you are using | Results 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.