Skip to main content

Guru Component

Manage cards, collections, and folders in the Guru knowledge management platform.

Component key: guru

Changelog ↓

Description

Guru is a knowledge management platform that helps teams capture, organize, and share information effectively. This component allows you to interact with the Guru REST API.

API Documentation

This component was built using the Guru API Documentation

Connections

User Token

Configuring a User Token

  1. Log into Guru
  2. Navigate to Manage > Apps and Integrations > API Access
  3. Select Generate User Token and copy the user token
  4. From the integration connection fill in the required fields:
    • Username: The Guru username or email address
    • User Token: The token obtained from your Guru account settings
InputNotesExample
Username

Your Guru username or email address.

User Token

Your user token for read/write access. Obtain this from your Guru account settings.

Triggers

Webhook Events

Manages Guru webhook subscriptions for your instance. On instance deploy, this trigger creates a webhook subscription in Guru (or reuses an existing one with matching URL and events). On instance deletion, it removes the subscription. The trigger validates incoming webhook requests and handles all webhook lifecycle management automatically. | key: webhook

InputNotesExample
Connection
Delivery Mode

The delivery mode of the webhook subscription.

BATCH
Active

Whether the webhook subscription is active.

true
Event Types

Select which event types should trigger the webhook. <strong>Important:</strong> Max 10 event types can be selected.

card-createdcard-updated

Data Sources

Select Card

Select a card from your Guru workspace | key: selectCard | type: picklist

InputNotesExample
Connection
Query

Advanced query using Guru query language syntax.

title:guide AND author:john
Query Type

The type of query to search for.

cards
Search Terms

Search terms to use in the search.

user guide tutorial

Select Collection

Select a collection from your Guru workspace | key: selectCollection | type: picklist

InputNotesExample
Connection
Search

The search term to use in the search.

user guide tutorial

Select Folder

Select a folder from your Guru workspace | key: selectFolder | type: picklist

InputNotesExample
Connection
Query

Advanced query using Guru query language syntax.

title:guide AND author:john
Search

The search term to use in the search.

user guide tutorial

Select Member

Select a member from your Guru team | key: selectMember | type: picklist

InputNotesExample
Connection
Search

The search term to use in the search.

user guide tutorial

Actions

Add User Group Member

Add a user group member | key: addUserGroupMember

InputNotesExample
Connection
Email

The user's email address. <strong>Important:</strong> Must be an existing Guru user.

john.doe@example.com
First Name

The user's first name.

John
Group ID

The ID of the group.

5f123b24-a3dc-4cc9-9f5a-d78fc1ffa43f
Last Name

The user's last name.

Doe

{
"data": [
{
"user": {
"id": "77777777-7777-7777-7777-777777777777",
"status": "PENDING",
"email": "newuser@example.com"
},
"id": "newuser@example.com",
"dateCreated": "2025-08-22T22:00:06.748+0000"
}
]
}

Create Card

Create a new card in Guru | key: createCard

InputNotesExample
Additional Properties

Additional properties to include in the request.

Card Content

The content/body of the card.

Subject: Welcome! Hello [Name].
Card Title

The title of the card.

My Card Title
Collection ID

The unique identifier of the collection.

0ea16439-ba25-4dca-a1b4-15861a9b123f
Connection
Share Status

The sharing status of the card.

TEAM

{
"data": {
"verificationReasons": [],
"verificationInitiationDate": "2025-11-20T19:33:23.074+0000",
"commentsEnabled": true,
"version": 1,
"permissions": [
"COLLECTION_VIEW",
"COLLECTION_CARD_VERIFY",
"COLLECTION_CREATE_FOLDERS",
"COLLECTION_ANNOUNCEMENT",
"COLLECTION_CARD_ARCHIVE",
"COLLECTION_MANAGE_FOLDERS",
"COLLECTION_CARD_UNVERIFY",
"COLLECTION_PUBLISH",
"COLLECTION_CARD_COMMENT",
"COLLECTION_CREATE_DRAFT_EXISTING",
"COLLECTION_MANAGE_CARD_SETTINGS",
"COLLECTION_CARD_DELETE",
"COLLECTION_CREATE_DRAFTS",
"COLLECTION_MANAGE_CARD_PERMISSIONS",
"COLLECTION_FOLDER_DELETE",
"COLLECTION_MANAGE_FOLDER_PERMISSIONS"
],
"id": "12345678-1234-1234-1234-123456789abc",
"content": "My card",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModified": "2025-08-22T19:33:23.023+0000",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastVerified": "2025-08-22T19:33:23.074+0000",
"lastVerifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"preferredPhrase": "Some Card Title",
"shareStatus": "PRIVATE",
"verificationInterval": 90,
"verificationType": "RELATIVE",
"dateCreated": "2025-08-22T19:33:23.023+0000",
"slug": "iRgdnKRT/Some-Card-Title",
"verificationState": "TRUSTED",
"cardType": "CARD",
"originalOwner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"commentCount": 0,
"followed": false,
"nextVerificationDate": "2025-11-20T19:33:23.074+0000"
}
}

Create Folder

Create a new folder in a collection | key: createFolder

InputNotesExample
Collection ID

The unique identifier of the collection.

0ea16439-ba25-4dca-a1b4-15861a9b123f
Connection
Folder Description

A description of the folder.

This folder contains...
Folder Title

The title of the folder.

My Folder
Parent Folder ID

The ID of the parent folder (optional for nested folders).

a350b7c1-e0d2-43b1-8e49-fc4d123b31a7

{
"data": {
"type": "folder",
"id": "55555555-5555-5555-5555-555555555555",
"itemId": "66666666-6666-6666-6666-666666666666",
"title": "A folder 2",
"lastModified": "2025-08-22T20:54:22.564+0000",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"items": [],
"slug": "ixaderdT/A-folder-2",
"numberOfFacts": 0
}
}

Create Webhook Subscription

Create a new webhook subscription to receive real-time Guru events | key: createWebhookSubscription

InputNotesExample
Connection
Delivery Mode

The delivery mode of the webhook subscription.

BATCH
Webhook URL

The URL where webhook events will be sent.

https://your-webhook-endpoint.com/webhook/abc123
Active

Whether the webhook subscription is active.

true
Event Types

Select which event types should trigger the webhook. <strong>Important:</strong> Max 10 event types can be selected.

card-createdcard-updated

{
"data": {
"id": "15151515-1515-1515-1515-151515151515",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"filter": "card-created,card-updated",
"status": "ENABLED",
"team": {
"organization": {
"name": "Example Team",
"id": "c325c95b-e4e6-4232-bc68-6f87d2b8c245"
},
"topLevelOrganizationId": "c325c95b-e4e6-4232-bc68-6f87d2b8c245",
"description": "A place for Developer's Developer Team to document processes and share important information.",
"name": "Developer's Developer Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-08-22T19:59:50.845+0000",
"targetUrl": "https://hooks.example.com/webhook",
"deliveryMode": "BATCH",
"dateLastModified": "2025-08-22T19:59:50.845+0000"
}
}

Delete All Webhook Subscriptions

Delete all webhook subscriptions for the current user (use with caution) | key: deleteAllWebhookSubscriptions

InputNotesExample
Connection

{
"data": {
"message": "Successfully deleted 2 webhook subscriptions",
"deletedCount": 2,
"failedCount": 0,
"totalCount": 2,
"deletedSubscriptions": [
"16161616-1616-1616-1616-161616161616",
"17171717-1717-1717-1717-171717171717"
],
"failedSubscriptions": []
}
}

Delete Card

Delete a card from Guru | key: deleteCard

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection

{
"data": {
"message": "Card deleted successfully",
"cardId": "12345678-1234-1234-1234-123456789abc"
}
}

Delete Folder

Delete a folder from Guru | key: deleteFolder

InputNotesExample
Connection
Folder ID

The unique identifier of the folder.

8b7bd513-9910-4116-989e-9a0ed9339380

{
"data": {
"message": "Folder deleted successfully",
"folderId": "55555555-5555-5555-5555-555555555555"
}
}

Delete User Group Member

Remove a user from a user group | key: deleteUserGroupMember

InputNotesExample
Connection
Group ID

The ID of the group.

5f123b24-a3dc-4cc9-9f5a-d78fc1ffa43f
Member ID

The ID of the member.

john.doe@example.com

{
"data": {
"message": "User removed from group successfully",
"groupId": "77777777-7777-7777-7777-777777777777",
"memberId": "newuser@example.com"
}
}

Delete Webhook Subscription

Delete a webhook subscription to stop receiving events | key: deleteWebhookSubscription

InputNotesExample
Connection
Webhook ID

The unique identifier of the webhook.

969123fb-6436-4a4e-8a78-20d79ff43804

{
"data": {
"message": "Webhook subscription deleted successfully",
"webhookId": "44444444-4444-4444-4444-444444444444"
}
}

Get Card

Retrieve a specific card with extended information including teams and collaborators | key: getCard

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection

{
"data": {
"verificationReasons": [],
"verificationInitiationDate": "2025-11-20T19:33:23.074+0000",
"knowledgeAlerts": [],
"hasDrafts": false,
"commentsEnabled": true,
"version": 1,
"permissions": [
"COLLECTION_MANAGE_FOLDER_PERMISSIONS",
"COLLECTION_CARD_ARCHIVE",
"COLLECTION_CARD_UNVERIFY",
"COLLECTION_MANAGE_CARD_SETTINGS",
"COLLECTION_MANAGE_FOLDERS",
"COLLECTION_CARD_DELETE",
"COLLECTION_CREATE_DRAFTS",
"COLLECTION_VIEW",
"COLLECTION_CARD_VERIFY",
"COLLECTION_ANNOUNCEMENT",
"COLLECTION_PUBLISH",
"COLLECTION_MANAGE_CARD_PERMISSIONS",
"COLLECTION_CARD_COMMENT",
"COLLECTION_CREATE_FOLDERS",
"COLLECTION_CREATE_DRAFT_EXISTING",
"COLLECTION_FOLDER_DELETE"
],
"id": "12345678-1234-1234-1234-123456789abc",
"content": "My card",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModified": "2025-08-22T19:33:23.023+0000",
"contentSchemaVersion": "1.0.0",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"collectionTypeDetail": "USER",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true
},
"verifiers": [
{
"type": "user",
"user": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"id": "user@example.com",
"dateCreated": "2025-08-22T19:33:23.023+0000"
}
],
"lastVerified": "2025-08-22T19:33:23.074+0000",
"lastVerifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"preferredPhrase": "Some Card Title",
"shareStatus": "PRIVATE",
"verificationInterval": 90,
"verificationType": "RELATIVE",
"dateCreated": "2025-08-22T19:33:23.023+0000",
"slug": "iRgdnKRT/Some-Card-Title",
"verificationState": "TRUSTED",
"guruSlateToolsVersion": "1.0.0",
"cardType": "CARD",
"originalOwner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"commentCount": 0,
"followed": false,
"nextVerificationDate": "2025-11-20T19:33:23.074+0000"
}
}

Get Card Folders

Get the folders that contain a specific card | key: getCardFolders

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection

{
"data": []
}

Get Collection

Retrieve details of a specific collection by ID | key: getCollection

InputNotesExample
Collection ID

The unique identifier of the collection.

0ea16439-ba25-4dca-a1b4-15861a9b123f
Connection

{
"data": {
"collectionStats": {
"stats": {
"collection-trust-score": {
"type": "collection-trust-score",
"trustedCount": 4,
"needsVerificationCount": 0
},
"card-count": {
"type": "card-count",
"count": 4
}
}
},
"publicCards": 1,
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"permissions": [
"COLLECTION_MANAGE_TEMPLATES",
"COLLECTION_MANAGE_TAGS",
"COLLECTION_MANAGE_SETTINGS",
"COLLECTION_CREATE_DRAFTS",
"COLLECTION_DELETE",
"COLLECTION_VIEW",
"COLLECTION_VIEW_USER_ANALYTICS",
"COLLECTION_CARD_UNVERIFY",
"COLLECTION_CARD_VERIFY",
"COLLECTION_CREATE_DRAFT_EXISTING",
"COLLECTION_VIEW_AUTHOR_ANALYTICS",
"COLLECTION_ANNOUNCEMENT",
"COLLECTION_MANAGE_CARDS",
"COLLECTION_MANAGE_CARD_PERMISSIONS",
"COLLECTION_CARD_COMMENT",
"COLLECTION_FOLDER_DELETE",
"COLLECTION_CARD_DELETE",
"COLLECTION_VIEW_CARD_ANALYTICS",
"COLLECTION_CARD_ARCHIVE",
"COLLECTION_MANAGE_FOLDERS",
"COLLECTION_MANAGE_CARD_SETTINGS",
"COLLECTION_PUBLISH",
"COLLECTION_MANAGE_FOLDER_PERMISSIONS",
"COLLECTION_MANAGE_PERMISSIONS",
"COLLECTION_CREATE_FOLDERS"
],
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"contexts": 0,
"team": {
"name": "Developer's Developer Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"boards": 121,
"dateCreated": "2025-08-05T18:05:41.675+0000",
"cards": 4,
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
}
}

Get Folder

Retrieve details of a specific folder by ID | key: getFolder

InputNotesExample
Connection
Folder ID

The unique identifier of the folder.

8b7bd513-9910-4116-989e-9a0ed9339380

{
"data": {
"description": "updated description",
"title": "Updated folder Title",
"id": "55555555-5555-5555-5555-555555555555",
"lastModified": "2025-08-22T20:54:22.803+0000",
"collection": {
"description": "",
"homeBoardSlug": "ExmplSlg/Example-Collection",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"items": [],
"slug": "ixaderdT/Updated-folder-Title",
"itemId": "66666666-6666-6666-6666-666666666666",
"numberOfFacts": 0
}
}

Get Folder Items

Retrieve all items (cards and subfolders) in a specific folder | key: getFolderItems

InputNotesExample
Connection
Fetch All

Turn on to fetch more than 50 folders.

false
Folder ID

The unique identifier of the folder.

8b7bd513-9910-4116-989e-9a0ed9339380

{
"data": []
}

Get Team Analytics

Retrieve analytics data for the team | key: getTeamAnalytics

InputNotesExample
Connection
Fetch All

Turn on to fetch more than 500 events.

false
From Date

The start date of the time range in YYYY-MM-DD format.

2024-01-01
Team ID

The ID of the team.

5f123b24-a3dc-4cc9-9f5a-d78fc1ffa43f
To Date

The end date of the time range in YYYY-MM-DD format.

2024-12-31

{
"data": [
{
"user": "user@example.com",
"properties": {
"factId": "fact1111-1111-1111-1111-111111111111",
"cardId": "fact1111-1111-1111-1111-111111111111",
"source": "API"
},
"type": "fact-shared-to-team",
"eventType": "card-shared-to-team",
"eventDate": "2025-08-20T23:03:15.709+0000"
}
]
}

Get Webhook Subscription

Retrieve details of a specific webhook subscription | key: getWebhookSubscription

InputNotesExample
Connection
Webhook ID

The unique identifier of the webhook.

969123fb-6436-4a4e-8a78-20d79ff43804

{
"data": {
"id": "44444444-4444-4444-4444-444444444444",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"filter": "card-created,card-updated",
"status": "ENABLED",
"team": {
"organization": {
"name": "Example Team",
"id": "c325c95b-e4e6-4232-bc68-6f87d2b8c245"
},
"topLevelOrganizationId": "c325c95b-e4e6-4232-bc68-6f87d2b8c245",
"description": "A place for Developer's Developer Team to document processes and share important information.",
"name": "Developer's Developer Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-08-22T19:29:56.106+0000",
"targetUrl": "https://hooks.example.com/webhook",
"deliveryMode": "BATCH",
"dateLastModified": "2025-08-22T19:29:56.106+0000"
}
}

List Card Verifiers

List the verifiers for a card | key: listCardVerifiers

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection

{
"data": [
{
"type": "user",
"user": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"id": "user@example.com",
"dateCreated": "2025-08-22T19:33:23.023+0000"
}
]
}

List Collection Group Access

Get details of all groups with access to a collection | key: listCollectionGroupAccess

InputNotesExample
Collection ID

The unique identifier of the collection.

0ea16439-ba25-4dca-a1b4-15861a9b123f
Connection

{
"data": [
{
"group": {
"modifiable": false,
"name": "All Members",
"id": "88888888-8888-8888-8888-888888888888",
"team": {
"organization": {
"name": "Example Team",
"id": "99999999-9999-9999-9999-999999999999"
},
"totalUsers": 0,
"topLevelOrganizationId": "99999999-9999-9999-9999-999999999999",
"description": "A place for Developer's Developer Team to document processes and share important information.",
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-04-29T20:49:22.599+0000",
"groupIdentifier": "team"
},
"groupId": "88888888-8888-8888-8888-888888888888",
"role": "MEMBER",
"objectRole": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"name": "Viewer",
"permissions": [
"COLLECTION_VIEW",
"PAGE_VIEW",
"KT_VIEW",
"SOURCE_VIEW",
"AGENT_VIEW",
"COLLECTION_CARD_COMMENT"
],
"roleType": "SYSTEM",
"systemRole": "VIEWER"
},
"groupName": "All Members"
}
]
}

List Collections

Retrieve a list of all collections accessible to the user | key: listCollections

InputNotesExample
Connection
Search

The search term to use in the search.

user guide tutorial

{
"data": [
{
"collectionStats": {
"stats": {
"collection-trust-score": {
"type": "collection-trust-score",
"needsVerificationCount": 0,
"trustedCount": 4
},
"card-count": {
"type": "card-count",
"count": 4
}
}
},
"publicCards": 1,
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"permissions": [
"COLLECTION_VIEW",
"COLLECTION_CREATE_FOLDERS",
"COLLECTION_FOLDER_DELETE",
"COLLECTION_CARD_ARCHIVE",
"COLLECTION_ANNOUNCEMENT",
"COLLECTION_CREATE_DRAFTS",
"COLLECTION_MANAGE_TEMPLATES",
"COLLECTION_MANAGE_PERMISSIONS",
"COLLECTION_CARD_UNVERIFY",
"COLLECTION_MANAGE_CARDS",
"COLLECTION_VIEW_USER_ANALYTICS",
"COLLECTION_MANAGE_FOLDERS",
"COLLECTION_VIEW_CARD_ANALYTICS",
"COLLECTION_CREATE_DRAFT_EXISTING",
"COLLECTION_PUBLISH",
"COLLECTION_MANAGE_SETTINGS",
"COLLECTION_DELETE",
"COLLECTION_CARD_COMMENT",
"COLLECTION_MANAGE_CARD_SETTINGS",
"COLLECTION_CARD_DELETE",
"COLLECTION_MANAGE_FOLDER_PERMISSIONS",
"COLLECTION_VIEW_AUTHOR_ANALYTICS",
"COLLECTION_MANAGE_TAGS",
"COLLECTION_CARD_VERIFY",
"COLLECTION_MANAGE_CARD_PERMISSIONS"
],
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"contexts": 0,
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"boards": 121,
"dateCreated": "2025-08-05T18:05:41.675+0000",
"cards": 4,
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
}
]
}

List Folders

Retrieve a list of all folders | key: listFolders

InputNotesExample
Connection
Fetch All

Turn on to fetch more than 110 folders.

false
Query

Advanced query using Guru query language syntax.

title:guide AND author:john
Search

The search term to use in the search.

user guide tutorial

{
"data": [
{
"home": true,
"title": "Example",
"id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
"lastModified": "2025-08-22T20:54:23.339+0000",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"items": [],
"slug": "ExmplSlg/Example-Collection",
"numberOfFacts": 4
}
]
}

List Team Members

Retrieve a list of all team members | key: listTeamMembers

InputNotesExample
Connection
Fetch All

Turn on to fetch more than 50 members.

false
Search

The search term to use in the search.

user guide tutorial

{
"data": [
{
"userAttributes": {
"BILLING_TYPE": "CORE"
},
"user": {
"id": "77777777-7777-7777-7777-777777777777",
"status": "PENDING",
"email": "newuser@example.com"
},
"id": "newuser@example.com",
"dateCreated": "2025-08-21T20:14:03.839+0000",
"groups": [
{
"modifiable": true,
"userModifiable": true,
"name": "Experts",
"id": "10101010-1010-1010-1010-101010101010",
"team": {
"organization": {
"name": "Example Team",
"id": "99999999-9999-9999-9999-999999999999"
},
"description": "A place for Developer's Developer Team to document processes and share important information.",
"totalUsers": 0,
"topLevelOrganizationId": "99999999-9999-9999-9999-999999999999",
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-04-29T20:49:22.521+0000",
"groupIdentifier": "experts"
},
{
"modifiable": true,
"userModifiable": true,
"name": "Test",
"id": "77777777-7777-7777-7777-777777777777",
"team": {
"organization": {
"name": "Example Team",
"id": "99999999-9999-9999-9999-999999999999"
},
"description": "A place for Developer's Developer Team to document processes and share important information.",
"totalUsers": 0,
"topLevelOrganizationId": "99999999-9999-9999-9999-999999999999",
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-08-21T20:06:09.370+0000",
"groupIdentifier": "test"
}
]
}
]
}

List User Groups

Returns all groups on the team | key: listUserGroups

InputNotesExample
Connection

{
"data": [
{
"modifiable": false,
"name": "All Members",
"id": "5f419b24-a3dc-4cc9-9f5a-d78fc1ffa43f",
"team": {
"organization": {
"name": "Example Team",
"id": "99999999-9999-9999-9999-999999999999"
},
"totalUsers": 0,
"topLevelOrganizationId": "99999999-9999-9999-9999-999999999999",
"description": "A place for Developer's Developer Team to document processes and share important information.",
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-04-29T20:49:22.599+0000",
"groupIdentifier": "team"
}
]
}

List Webhook Subscriptions

Retrieve all webhook subscriptions for the current user | key: listWebhookSubscriptions

InputNotesExample
Connection

{
"data": [
{
"id": "18181818-1818-1818-1818-181818181818",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"filter": "card-created,card-updated",
"status": "ENABLED",
"team": {
"organization": {
"name": "Example Team",
"id": "99999999-9999-9999-9999-999999999999"
},
"description": "A place for Developer's Developer Team to document processes and share important information.",
"topLevelOrganizationId": "99999999-9999-9999-9999-999999999999",
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-08-22T19:19:50.869+0000",
"targetUrl": "https://hooks.example.com/webhook",
"deliveryMode": "BATCH",
"dateLastModified": "2025-08-22T19:19:50.869+0000"
}
]
}

Raw Request

Send raw HTTP request to Guru API | key: rawRequest

InputNotesExample
Connection
Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/cards), The base URL is already included (https://api.getguru.com/api/v1). For example, to connect to https://api.getguru.com/api/v1/cards, only /cards is entered in this field.

/cards
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

Search Cards

Search for cards and content in Guru | key: searchCards

InputNotesExample
Connection
Fetch All

Turn on to fetch more than 50 cards.

false
Max Results

The maximum number of results to return.

50
Query

Advanced query using Guru query language syntax.

title:guide AND author:john
Query Type

The type of query to search for.

cards
Search Terms

Search terms to use in the search.

user guide tutorial

{
"data": [
{
"commentsEnabled": true,
"id": "13131313-1313-1313-1313-131313131313",
"content": "Updated content",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"lastModified": "2025-08-22T19:33:25.487+0000",
"collection": {
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"publicCardsEnabled": false,
"collectionTypeDetail": "USER"
},
"lastVerified": "2025-08-22T19:33:25.160+0000",
"lastVerifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"shareStatus": "PRIVATE",
"preferredPhrase": "Updated Title",
"verifiers": [
{
"type": "user",
"user": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"id": "user@example.com"
}
],
"verificationInterval": 90,
"dateCreated": "2025-08-22T19:33:23.876+0000",
"slug": "ibgdGKeT/Updated-Title",
"verificationState": "TRUSTED",
"cardType": "CARD",
"originalOwner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"highlightedAttachments": [],
"followed": false,
"highlightedTitleContent": [],
"nextVerificationDate": "2025-11-20T19:33:25.160+0000"
}
]
}

Search Folders

Search for folders by title or description | key: searchFolders

InputNotesExample
Collection ID

The unique identifier of the collection.

0ea16439-ba25-4dca-a1b4-15861a9b123f
Connection
Search Terms

Search terms to use in the search.

user guide tutorial

{
"data": [
{
"home": true,
"title": "Example",
"id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
"lastModified": "2025-08-22T20:54:23.339+0000",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "example@email.io",
"lastName": "Example",
"firstName": "Developer"
},
"items": [],
"slug": "ExmplSlg/Example-Collection",
"numberOfFacts": 4
}
]
}

Test Webhook

Send a test event to a webhook subscription to verify it's working | key: testWebhook

InputNotesExample
Connection
Test Data

The data to send to the webhook.

Webhook ID

The unique identifier of the webhook.

969123fb-6436-4a4e-8a78-20d79ff43804

{
"data": {
"message": "Test webhook sent successfully",
"webhookId": "44444444-4444-4444-4444-444444444444"
}
}

Unverify Card

Remove verification from a card | key: unverifyCard

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection
Verification Reason

Optional reason for the verification status.

Information is current and accurate

{
"data": {
"verificationInitiationDate": "2025-08-22T19:33:23.846+0000",
"commentsEnabled": false,
"verificationInitiator": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
}
}
}

Update Card

Update an existing card in Guru | key: updateCard

InputNotesExample
Additional Properties

Additional properties to include in the request.

Card Content

The content/body of the card.

Subject: Welcome! Hello [Name].
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Card Title

The title of the card.

My Card Title
Connection
Share Status

The sharing status of the card.

{
"data": {
"version": 2,
"verificationReasons": [],
"verificationInitiationDate": "2025-11-20T19:33:24.277+0000",
"hasDrafts": false,
"commentsEnabled": true,
"permissions": [
"COLLECTION_MANAGE_CARD_PERMISSIONS",
"COLLECTION_CARD_VERIFY",
"COLLECTION_MANAGE_FOLDER_PERMISSIONS",
"COLLECTION_FOLDER_DELETE",
"COLLECTION_CARD_COMMENT",
"COLLECTION_CREATE_DRAFT_EXISTING",
"COLLECTION_MANAGE_FOLDERS",
"COLLECTION_CREATE_FOLDERS",
"COLLECTION_PUBLISH",
"COLLECTION_ANNOUNCEMENT",
"COLLECTION_CREATE_DRAFTS",
"COLLECTION_CARD_UNVERIFY",
"COLLECTION_VIEW",
"COLLECTION_CARD_DELETE",
"COLLECTION_MANAGE_CARD_SETTINGS",
"COLLECTION_CARD_ARCHIVE"
],
"id": "12345678-1234-1234-1234-123456789abc",
"content": "Updated content",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModified": "2025-08-22T19:33:24.232+0000",
"collection": {
"description": "",
"homeBoardSlug": "ExmplSlg/Example-Collection",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastVerified": "2025-08-22T19:33:24.277+0000",
"lastVerifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"preferredPhrase": "Updated Title",
"shareStatus": "PRIVATE",
"verificationInterval": 90,
"verificationType": "RELATIVE",
"dateCreated": "2025-08-22T19:33:23.023+0000",
"slug": "iRgdnKRT/Updated-Title",
"verificationState": "TRUSTED",
"cardType": "CARD",
"originalOwner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"commentCount": 0,
"followed": false,
"nextVerificationDate": "2025-11-20T19:33:24.277+0000"
}
}

Update Folder

Update an existing folder | key: updateFolder

InputNotesExample
Connection
Folder Description

A description of the folder.

This folder contains...
Folder ID

The unique identifier of the folder.

8b7bd513-9910-4116-989e-9a0ed9339380
Folder Title

The title of the folder.

My Folder
Parent Folder ID

The ID of the parent folder (optional for nested folders).

a350b7c1-e0d2-43b1-8e49-fc4d123b31a7

{
"data": {
"description": "updated description",
"title": "Updated folder Title",
"id": "55555555-5555-5555-5555-555555555555",
"lastModified": "2025-08-22T20:54:22.803+0000",
"collection": {
"homeBoardSlug": "ExmplSlg/Example-Collection",
"description": "",
"name": "Example Collection",
"id": "22222222-2222-2222-2222-222222222222",
"color": "#001496",
"collectionType": "INTERNAL",
"team": {
"name": "Example Team",
"id": "33333333-3333-3333-3333-333333333333"
},
"dateCreated": "2025-08-05T18:05:41.675+0000",
"slug": "exmpl/Example-Collection",
"assistEnabled": false,
"publicCardsEnabled": true,
"collectionTypeDetail": "USER"
},
"lastModifiedBy": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"items": [],
"slug": "ixaderdT/Updated-folder-Title",
"itemId": "66666666-6666-6666-6666-666666666666",
"numberOfFacts": 0
}
}

Update Webhook Subscription

Update an existing webhook subscription settings | key: updateWebhookSubscription

InputNotesExample
Connection
Delivery Mode

The delivery mode of the webhook subscription.

BATCH
Webhook URL

The URL where webhook events will be sent.

https://your-webhook-endpoint.com/webhook/abc123
Active

Whether the webhook subscription is active.

true
Event Types

Select which event types should trigger the webhook. <strong>Important:</strong> Max 10 event types can be selected.

card-createdcard-updated
Webhook ID

The unique identifier of the webhook.

969123fb-6436-4a4e-8a78-20d79ff43804

{
"data": {
"id": "44444444-4444-4444-4444-444444444444",
"owner": {
"id": "11111111-1111-1111-1111-111111111111",
"status": "ACTIVE",
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"filter": "card-created,card-updated,board-updated",
"status": "ENABLED",
"team": {
"organization": {
"name": "Example Team",
"id": "c325c95b-e4e6-4232-bc68-6f87d2b8c245"
},
"topLevelOrganizationId": "c325c95b-e4e6-4232-bc68-6f87d2b8c245",
"description": "A place for Developer's Developer Team to document processes and share important information.",
"name": "Developer's Developer Team",
"id": "33333333-3333-3333-3333-333333333333",
"status": "ACTIVE",
"dateCreated": "2025-04-29T20:49:22.391+0000",
"profilePicUrl": "https://assets.getguru.com/default-team-logo.png"
},
"dateCreated": "2025-08-22T19:29:56.106+0000",
"targetUrl": "https://hooks.example.com/webhook",
"deliveryMode": "BATCH",
"dateLastModified": "2025-08-22T19:29:57.440+0000"
}
}

Verify Card

Mark a card as verified | key: verifyCard

InputNotesExample
Card ID

The unique identifier of the card.

73791e85-09f5-4098-983c-e677a8bd123b
Connection
Verification Reason

Optional reason for the verification status.

Information is current and accurate
Verification Status

The verification status to set for the card.

VERIFIED

{
"data": {
"message": "Card verified successfully",
"cardId": "12345678-1234-1234-1234-123456789abc"
}
}

Who Am I

Get information about the current authenticated user | key: whoAmI

InputNotesExample
Connection

{
"data": {
"tokenType": "API",
"user": {
"email": "user@example.com",
"lastName": "Doe",
"firstName": "Jane"
},
"team": {
"name": "Developer's Developer Team",
"id": "33333333-3333-3333-3333-333333333333",
"edition": {
"adminOverrides": {
"CALLOUT_ELEMENTS_ALLOWED": "true",
"GURU_GPT_ALLOWED": "true",
"ANSWER_GEN_CHUNKS_ALLOWED": "true",
"INSIGHTS_DIGEST_ALLOWED": "true",
"CARD_COMMENTS_ALLOWED": "true",
"ORG_CHART_ALLOWED": "true",
"GEN_AI_READ_ONLY_ALLOWED": "true",
"SEARCH_ASSISTANTS_ALLOWED": "true",
"ANALYTICS_NON_ADMIN_ALLOWED": "true",
"ENABLE_NEW_DIGEST_EMAILS": "true",
"GEN_AI_FULLCARD_SUMMARY_ALLOWED": "true",
"COLLAPSIBLE_ELEMENTS_ALLOWED": "true",
"ANSWER_GEN_ALLOWED": "true",
"COLLECTION_AUTO_ARCHIVE_ALLOWED": "true",
"ADMIN_MFA_NOT_REQUIRED": "true"
},
"name": "Developer",
"key": "developer",
"id": "12121212-1212-1212-1212-121212121212",
"code": "developer"
}
}
}
}

Changelog

2025-10-17

Enhanced webhook lifecycle management with improved trigger subscription handling and automated cleanup.

2025-08-28

Initial release of component featuring management of various record types and webhook subscriptions.