API Tokens

There are two types of API tokens: user tokens and collection tokens. User tokens have read and write permissions. Collection tokens are read-only and scoped to a single collection in your Guru workspace.

Use the comparison below to decide which credential type fits your project.

	User token	Collection token
Permissions	Read and write.	Read-only.
Authorization level	Authorized at the user level.	Authorized at the collection level.
Supported requests	GET, POST, PUT, DELETE.	GET requests only.
Result scope	Results are based on the permissions of the user whose token you use. For example, a token from a Team Admin can do more than a token from a user with Author permissions in some collections.	GET requests only return results from the collection associated with the token.

📘
Finding your collection ID
When using a collection token, you first need the collection ID. Use a user token to get all collections on your team.