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|
|Read/Write permissions||Read-only permissions|
|Authorized at the User-level||Authorized at the Collection-level|
|GET, POST, PUT, DELETE requests||GET requests only|
|The results of your requests will be based on the level of authorization associated with the User whose token you are using. (I.E. A User token with Team Admin permissions will be able to do more than a User token with only Author permissions in some Collections.)||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.
Updated about 2 months ago