---
updatedAt: 2026-08-27T17:22:40.000Z
agentTools:
  projectIndex: https://developer.getguru.com/llms.txt
---

# API Tokens

Compare user tokens and collection tokens to pick the right credential for your integration.

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](https://developer.getguru.com/reference/getv1collectionsgetcollections) on your team.