# Guru Documentation ## Guides - [Welcome to the Guru Developer Network](https://developer.getguru.com/docs/welcome.md): Welcome to our developer documentation. We're here to empower you to leverage Guru’s platform effectively. Whether you're building complex integrations or crafting simple automations, we've got you covered. - [Impersonation Tokens](https://developer.getguru.com/docs/impersonation-tokens.md) - [OAuth2 Clients](https://developer.getguru.com/docs/oauth2-clients.md) - [OAuth2 Example: Custom GPT](https://developer.getguru.com/docs/oauth2-example-custom-gpt.md) - [Creating a Webhook](https://developer.getguru.com/docs/creating-a-webhook.md) - [Deleting a Webhook](https://developer.getguru.com/docs/delete-a-webhook.md) - [Webhooks](https://developer.getguru.com/docs/getting-started-with-gurus-webhook-services.md) - [Receiving a Webhook Event](https://developer.getguru.com/docs/receiving-a-webhook-event.md) - [Testing & Monitoring a Webhook](https://developer.getguru.com/docs/testing-monitoring-webhook.md) - [Updating a Webhook](https://developer.getguru.com/docs/updating-a-webhook.md) - [Python SDK](https://developer.getguru.com/docs/getting-started-with-the-guru-sdk.md) - [Publishing Guru Cards to a Third-Party](https://developer.getguru.com/docs/publishing-guru-cards-to-a-third-party.md) - [Using the SDK for Syncs or Imports](https://developer.getguru.com/docs/using-the-sdk-for-syncs-or-imports.md) - [Authentication & Connection Setup](https://developer.getguru.com/docs/authentication-connection-setup.md): Connecting your Guru account to an MCP client is fast and secure. You can authenticate using **OAuth 2.0** (recommended) or an **API token**. - [Available Capabilities](https://developer.getguru.com/docs/available-capabilities.md): The Guru MCP Server provides tools that your AI client can use automatically — no API calls or code required. - [Connections for Developers](https://developer.getguru.com/docs/connections.md): This doc shows you how to connect different development tools to Guru's MCP Server. - [MCP Server](https://developer.getguru.com/docs/guru-mcp-server-overview.md): Bring Guru’s trusted knowledge into any AI or MCP-compatible application — no code, no API setup required. - [Inspiration](https://developer.getguru.com/docs/inspiration.md): Bring the power of Guru’s verified knowledge directly into your development workflow. With Guru’s MCP server, your IDE becomes an intelligent teammate that can access trusted company knowledge, document new ideas, and keep your work aligned—all without ever leaving your editor. - [Integration Platforms](https://developer.getguru.com/docs/integration-platforms.md): Guru integrates seamlessly with leading **Integration Platform as a Service (iPaaS)** tools — enabling teams to automate knowledge capture, sync systems, and keep information flowing where it’s needed most. - [Guru API Overview](https://developer.getguru.com/docs/getting-started.md): Guru's REST API enables developers to interact with Guru's platform programmatically. Here’s a summary of what you need to know to get started. - [Pagination](https://developer.getguru.com/docs/paging.md): Dealing with pagination of results - [User Tokens vs Collection Tokens](https://developer.getguru.com/docs/user-tokens-vs-collection-tokens.md): Understanding the differences between User-based tokens and Collection-based tokens - [Analytics](https://developer.getguru.com/docs/analytics.md) - [Get Team Stats](https://developer.getguru.com/docs/get-team-stats.md) - [List Ticket Linking Analytics](https://developer.getguru.com/docs/link-zendesksalesforce-tickets-to-guru-cards.md) - [List Analytics Data](https://developer.getguru.com/docs/list-analytics-data.md): The raw data that powers Guru's Analytics Dashboard is available for export. - [Collection Exports](https://developer.getguru.com/docs/collection-exports.md) - [Download Cards to PDF](https://developer.getguru.com/docs/download-cards-to-pdf.md) - [Get Card Attachments](https://developer.getguru.com/docs/get-card-attachments.md) - [Guru Query Language](https://developer.getguru.com/docs/guru-query-language.md) - [Historical Card Versions](https://developer.getguru.com/docs/historical-card-versions.md): This guide explains how to use the Guru Cards API to retrieve current and historical versions of a card. This is useful if you need to audit changes, display previous content, or analyze how a card has evolved over time. By the end of this article, you’ll know how to fetch the current version of a card, identify which version is current, list all historical versions, and retrieve a specific past version of a card. - [Cards and Folders](https://developer.getguru.com/docs/import-content.md) - [Listing Cards](https://developer.getguru.com/docs/listing-cards.md) - [Exporting Guru Cards to a Third-Party App or Website](https://developer.getguru.com/docs/syncing-cards.md): Learn how to create a customer-facing Help Center by using Guru's API to publish Cards - [Exporting Folders to PDF Asynchronously](https://developer.getguru.com/docs/exporting-folders-to-pdf.md): This guide explains how to use our API to export folders to PDF. The process involves retrieving a folder ID, initiating the export job, checking the status of the operation, and finally downloading the PDF using the provided URL. - [Folders API](https://developer.getguru.com/docs/folders-api.md) - [Bulk Upload Profile Avatars via the API](https://developer.getguru.com/docs/bulk-upload-profile-avatars-via-the-api.md) - [Updating Profiles](https://developer.getguru.com/docs/updating-profiles.md) - [Custom Sources for Answers](https://developer.getguru.com/docs/custom-sources-for-answers.md): This guide shows you how to set up a Custom Source in Guru and load records via Zapier. - [Guru Manual Sync](https://developer.getguru.com/docs/guru-manual-sync.md) - [[LEGACY] Guru Manual Sync](https://developer.getguru.com/docs/guru-sync-manual-api-legacy.md) - [Guru to Salesforce Flowchart](https://developer.getguru.com/docs/guru-to-salesforce-flowchart.md) - [[LEGACY] Importing a .zip Directory](https://developer.getguru.com/docs/importing-a-zip-directory-legacy.md) - [Importing a .zip Directory](https://developer.getguru.com/docs/importing-a-zip-directory.md) - [Sync Data to Guru using iPaaS](https://developer.getguru.com/docs/sync-data-to-guru-using-ipaas.md) - [Creating and Updating Tags](https://developer.getguru.com/docs/creating-updating-and-deleting-tags.md) - [Listing, Creating, Updating, and Deleting Tag Categories](https://developer.getguru.com/docs/tag-categories.md) ## API Reference - [Overview](https://developer.getguru.com/reference/authentication.md): Learn how to authenticate in order to use Guru's API - [List events](https://developer.getguru.com/reference/getv1teamsanalyticsgetanalytics.md): Returns all events for the team. Date range parameters can be added. A maximum of 500 events will be returned. If more than 500 events exist, a link to the next page of results will be included in the Link header - [Unassign an answer from an expert](https://developer.getguru.com/reference/deletev1answersunassignexpert.md) - [Ask a Question](https://developer.getguru.com/reference/postv1answerscreateanswer.md): Ask Guru a question, and receive an AI-generated answer with up to three source records. - [Assign an answer to an expert](https://developer.getguru.com/reference/putv1answersassignexpert.md) - [Get Knowledge Assistants](https://developer.getguru.com/reference/getv1assistantsgetassistants.md) - [Delete card comment](https://developer.getguru.com/reference/deletev1cardscommentsdeletecomment.md) - [List card comments](https://developer.getguru.com/reference/getv1cardscommentsgetcomments.md): Returns all undeleted card comments accessible to the authenticated user. A maximum of 25 card comments will be returned. If more than 25 card comments exist, a link to the next page of results will be included in the Link header - [Create card comment](https://developer.getguru.com/reference/postv1cardscommentscreatecomment.md): Comment content is required - [Get card verifier](https://developer.getguru.com/reference/getv1cardsverifiersgetverifier.md) - [List card verifiers](https://developer.getguru.com/reference/getv1cardsverifiersgetverifiers.md) - [Replace card verifiers](https://developer.getguru.com/reference/postv1cardsverifiersupsertverifier.md): Create a card verifier and delete all existing verifiers - [Delete card](https://developer.getguru.com/reference/deletev1cardsdeletefact.md) - [Get card](https://developer.getguru.com/reference/getv1cardsgetextendedfact.md): Load the card and the card teams and collaborators. If there are more than 25 teams or collaborators, a Link header will be provided for the next page of results. - [List favorite lists including this card](https://developer.getguru.com/reference/getv1cardsgetfactfavoritelists.md) - [List folders a card is on](https://developer.getguru.com/reference/getv1cardsgetfactfolders.md) - [List unverified cards](https://developer.getguru.com/reference/getv1cardsgetverificationmanager.md): Returns all unverified cards accessible by the authenticated user. A maximum of 50 cards will be returned. If more than 50 cards exist, a link to the next page of results will be included in the Link header - [Create card](https://developer.getguru.com/reference/postv1cardscreateextendedfact.md): Content and title are required. Card share status should be set to TEAM to make a card team shared. Omitting the share status value or setting it to PRIVATE will result in a card that is only accessible by the card owner. This endpoint allows the verifier to be set upon card creation, rather than requiring a separate call. - [Unverify card](https://developer.getguru.com/reference/postv1cardsunverifyfact.md): Mark the card with the given cardId as unverified - [Update Card](https://developer.getguru.com/reference/putv1cardsupdateextendedfact.md): This endpoint allows the verifier to be set upon card creation, rather than requiring a separate call. Content and title are required. Card share status should be set to TEAM to make a card team shared. Omitting the share status value or setting it to PRIVATE will result in a card that is only accessible by the card owner. If tags are omitted or an empty list, then all existing tags will be removed from the card. - [Verify card](https://developer.getguru.com/reference/putv1cardsverify.md) - [Find collection by ID](https://developer.getguru.com/reference/getv1collectionsgetcollection.md) - [List collection group access](https://developer.getguru.com/reference/getv1collectionsgetcollectionaccess.md): Get details of all groups with access to a collection. - [List collections](https://developer.getguru.com/reference/getv1collectionsgetcollections.md): Returns all undeleted collections created in the workspace associated with the user's API token. The user must have permissions to a collection in order to see it in the results. - [Delete folder](https://developer.getguru.com/reference/deletev1foldersdeletefolder.md) - [Search for folders](https://developer.getguru.com/reference/getv1foldersfoldersearch.md) - [Get folder effective permissions](https://developer.getguru.com/reference/getv1foldersgeteffectivepermissions.md): Get permissions that are applied to a folder - this includes permissions configured on the folder itself, as well as permissions that are configured at a folder higher up in the hierarchy. - [Get folder](https://developer.getguru.com/reference/getv1foldersgetfolder.md): Including a Folder's ID will load information about a single folder with its cards and sections. With this call, you can also return a 'Home Folder', which is what we call the structure that lists what Folders exist within a collection. To return this information, set the `folderId` to `homeBoardSlug` from the collection's response - [Export folder to PDF](https://developer.getguru.com/reference/getv1foldersgetfolderaspdf.md): Timeout set to 2 minutes. If you experience a timeout, please contact our support team - [Get folder items](https://developer.getguru.com/reference/getv1foldersgetfolderitems.md): Gets items (cards and folders) that live directly within a folder. A maximum of 50 folder items will be returned. If more than 50 items exist, a link to the next page of results will be included in the Link header - [Get folder permissions](https://developer.getguru.com/reference/getv1foldersgetfolderpermissions.md): Gets the permissions that are configured at the folder level. - [List folders](https://developer.getguru.com/reference/getv1foldersgetfolders.md): Returns all undeleted folders the current user has access to. A maximum of 110 folders will be returned. If more than 110 folders exist, a link to the next page of results will be included in the Link header - [Get folder parent](https://developer.getguru.com/reference/getv1foldersgetparentfolder.md) - [Create folder](https://developer.getguru.com/reference/postv1folderscreatenewfolder.md): Title is required - [Update folder](https://developer.getguru.com/reference/putv1foldersupdatefolder.md) - [Delete an announcement](https://developer.getguru.com/reference/deletev1alertsdeletealert.md) - [Get announcement stats](https://developer.getguru.com/reference/getv1alertsgetalertstatfull.md) - [Get announcement stats summary](https://developer.getguru.com/reference/getv1alertsgetalertstatsummary.md) - [Get announcement user stats](https://developer.getguru.com/reference/getv1alertsgetalertstatusers.md) - [List announcements](https://developer.getguru.com/reference/getv1alertsgetdelegatedalerts.md): Returns all announcements owned by the authenticated user. A maximum of 50 announcements will be returned. If more than 50 announcements exist, a link to the next page of results will be included in the Link header - [Create an announcement](https://developer.getguru.com/reference/postv1alertscreatealert.md) - [Export announcement user details](https://developer.getguru.com/reference/postv1alertsexportalertusers.md): Initiates the export of user details for the announcement with the given announcementId. Results will be emailed when available. - [Send announcement reminders](https://developer.getguru.com/reference/postv1alertssendalertreminder.md): Sends announcement reminders to any users who have not yet read the announcement - [Mark an announcement alert as read](https://developer.getguru.com/reference/putv1alertsmarkalertread.md) - [Delete a ticket link](https://developer.getguru.com/reference/deletev1kcsdeletekcs.md) - [Disable a ticket linking platform](https://developer.getguru.com/reference/deletev1kcsdeletekcsapp.md) - [List ticket links](https://developer.getguru.com/reference/getv1kcsgetkcs.md): Returns all ticket links for the authenticated team. A maximum of 25 ticket links will be returned. If more than 25 ticket links exist, a link to the next page of results will be included in the Link header - [Get enabled ticket linking platforms](https://developer.getguru.com/reference/getv1kcsgetkcsapps.md) - [Create a ticket link](https://developer.getguru.com/reference/postv1kcscreatekcs.md) - [Enable a ticket linking platform](https://developer.getguru.com/reference/putv1kcsaddkcsapp.md) - [Lists user's direct reports](https://developer.getguru.com/reference/getv1peoplegetdirectreports.md) - [Get profile](https://developer.getguru.com/reference/getv1peoplegetperson.md) - [Update profile](https://developer.getguru.com/reference/putv1peopleupdateperson.md) - [Search for cards](https://developer.getguru.com/reference/getv1searchquerysearch.md): A maximum of 50 cards will be returned. If more than 50 cards exist, a link to the next page of results will be included in the Link header - [Search for cards](https://developer.getguru.com/reference/getv1searchquerysearchcardmgr.md): A maximum of 50 cards will be returned. If more than 50 cards exist, a link to the next page of results will be included in the Link header - [Search with Sources](https://developer.getguru.com/reference/postv1searchkeyworddocumentsearch.md): Search across Guru and your connected Sources. - [Search for cards using JSON query](https://developer.getguru.com/reference/postv1searchquerysearchbyjsonforcardmanager.md): A maximum of 50 cards will be returned. If more than 50 cards exist, a link to the next page of results will be included in the Link header - [Delete a tag category](https://developer.getguru.com/reference/deletev1teamstagcategoriesdeletetagcategory.md) - [Get a tag](https://developer.getguru.com/reference/getv1teamstagcategoriesgettag.md) - [List tag categories](https://developer.getguru.com/reference/getv1teamstagcategoriesgettagcategories.md) - [Create a tag](https://developer.getguru.com/reference/postv1teamstagcategoriescreatetag.md) - [Create a tag category](https://developer.getguru.com/reference/postv1teamstagcategoriescreatetagcategory.md) - [Update a tag](https://developer.getguru.com/reference/putv1teamstagcategoriesupdatetag.md) - [Update a tag category](https://developer.getguru.com/reference/putv1teamstagcategoriesupdatetagcategory.md) - [List user mentions](https://developer.getguru.com/reference/getv1tasksgetmentions.md) - [List team members](https://developer.getguru.com/reference/getv1membersgetteammembers.md): Returns all team members. A maximum of 50 team members will be returned. If more than 50 team members exist, a link to the next page of results will be included in the Link header - [Get a team's stats](https://developer.getguru.com/reference/getv1teamsgetteamstats.md): Team stats will include counts of trusted and unverified cards, as well as overall trust score and team card count. - [Delete a card template](https://developer.getguru.com/reference/deletev1templatesdeletetemplate.md) - [List card templates](https://developer.getguru.com/reference/getv1templatesgetalltemplatesbyteam.md) - [Get a card template](https://developer.getguru.com/reference/getv1templatesgettemplate.md) - [Create a card template](https://developer.getguru.com/reference/postv1templatescreatetemplate.md) - [Update a card template](https://developer.getguru.com/reference/putv1templatesupdatetemplate.md) - [Delete a user group member](https://developer.getguru.com/reference/deletev1groupsdeleteusergroupmember.md) - [List group collection access](https://developer.getguru.com/reference/getv1groupsgetcollections.md) - [List group members](https://developer.getguru.com/reference/getv1groupsgetgroupmembers.md): Returns all group members. A maximum of 100 group members will be returned. If more than 100 group members exist, a link to the next page of results will be included in the Link header - [List user groups](https://developer.getguru.com/reference/getv1groupsgetusergroups.md): Returns all groups on the team. - [Add a user group member](https://developer.getguru.com/reference/postv1groupscreateusergroupmember.md) - [Get user information](https://developer.getguru.com/reference/getv1whoamiwhoami.md): Get basic information about the authenticated user or collection, including their team, and their authentication token ## Pages - [Guru API Status](https://developer.getguru.com/guru-api-status.md) - [New API Endpoints - 10/6/2022](https://developer.getguru.com/new-api-endpoints-1062022.md) - [New API Endpoints - 5/25/2022](https://developer.getguru.com/new-api-endpoints-5252022.md)