Leveraging Guru's API

Obtaining a User Token

User tokens allow both read and write access to Guru’s API based on the permissions of the user generating the token.

✍️

Note

The only exception is the Analytics API. While Authors can view Analytics in the web app, only Admins can access Analytics data via the API because it includes data for all users.

Steps to generate a User token:

1. Go to the Apps & Integrations page under the Manage menu.
2. Click the API Access tab.
3. Click Generate User Token and enter your name.
4. To generate a token for another user, click Generate a new user token.
5. To manage tokens:
   • Reissue a token using the circular arrow icon
   • Revoke a token using the trash can icon

Authentication

• Username: your Guru username
• Password: the API token you generated (not your web app password)

You can test your credentials on the Developer Site.

Obtaining a Collection Token

Collection tokens provide read-only access to content in a specific Collection.

📘

Best Practices

Use Collection tokens when you only need to expose or retrieve public-facing knowledge from one Collection.

Steps to generate a Collection token:

1. Go to the API Access tab.
2. Click Generate a New Collection Token.
3. Select the desired Collection from the dropdown list.

Authentication

• Username: the Collection ID
• Password: the Collection token

✍️

Note

To retrieve your Collection ID, use a User token to query all Collections in your workspace.

Frequently Asked Questions about Guru’s API

I’m getting a 401 error. What does this mean?

A 401 Unauthorized error means your credentials are invalid. Double-check that:

• Your token is correct (try reissuing if needed)
• You are using the proper permissions for your API call
  Review user roles and permissions

Why do I only see 50 results in my API response?

Guru paginates results. To retrieve more than 50 items, follow the paging instructions.

Do API tokens expire?

No. API tokens do not expire unless manually revoked by an Admin. You can delete and reissue tokens at any time.

Can I use Guru’s API to publish content externally?

Yes. Although Guru is designed for internal knowledge sharing, you can publish content externally using our API documentation.