Guru Component
Manage cards, collections, and folders in the Guru knowledge management platform.
Component key: guru
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
- Log into Guru
- Navigate to Manage > Apps and Integrations > API Access
- Select Generate User Token and copy the user token
- 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| Connection | ||
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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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
| Input | Notes | Example |
|---|---|---|
| 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.