Skip to main content

API & Integrations

Discuss the Guru API, Zapier and Workato workflows, and integrations with Guru

  • 133 Posts
  • 375 Replies
133 Posts
Callie Rojewski
Callie RojewskiGenius
posted in API & Integrations
Automating Guru tasks with Zapier: how to get started?

Hey everyone! In the spirit of next week’s Guru Deep Dive, I want to talk through tips and tricks when it comes to automating Guru tasks. Yesterday, a group of us were brainstorming ways to use Guru’s Zapier and Workato integrations, and it inspired me to think through ways I could automate Guru tasks I manage in my day-to-day role. There are soo many possibilities to think of, so to get started, I listed out my top challenges.  Challenges → What am I doing manually, that there could be a workaround for? Is there a way to get notifications to manage tasks in a place I’m already going for project management or looking on a day-to-day basis?  I then explored workflows by mapping:The trigger (the first activity) The action (the correlated activity) The end resultFor example, I set up a workflow for card verification. If I’m being fully transparent I’m probably not the best at keeping my cards verified as soon as they expire  I AM good at checking slack though, so I set up a Zapier to send

1131
Sarah W
A
Anonymous
posted in API & Integrations
If you could wave a magic wand, what Guru-related process would you automate?

We’re excited to host a Guru Community AMA (ask me anything) on Aug. 18th with @Mary Houston (Sr. Manager, Developer Advocate) and @Jon Saft (Product Manager, Bots & Integrations), where you can get any and all of your questions answered about the Guru API, webhooks, and Workato/Zapier automations.Here are some questions to get your wheels turning (share your thoughts below!)…If you could wave a magic wand, what Guru-related workflow process would you automate? What manual process do you manage now that you’d love to automate? What about the Guru API, iPaaS (Zapier/Workato) integrations, or webhooks feels confusing or out of reach?

924
A
Devon O'Dwyer
Guru Employee
Devon O'DwyerGuru Senior Product Specialist
published in API & Integrations
How to create an API & Integrations post

Welcome! The API & Integrations category is the best place for you to ask questions about the Guru API, webhooks, Zapier and Workato workflows, and integrations with Guru. Here are some tips on posting in the API & Integrations category: Search before you post We recommend doing a quick search to see if your question has been answered before you post. If there’s an open relevant discussion, feel free to add a comment to continue the conversation! What kinds of posts should I make?Questions about how you can use our Guru API, for example:  How can I use the API to move Cards from one Collection to another?  Has anyone piped API data to Tableau?  Is it possible to get a list of all users who have modified a Card? Questions about what kinds of automated workflows you can create with Zapier and WorkatoMark a question as a best answerIf you ask a question and receive an informative answer, feel free to mark it as a best answer to help others in the community moving forward!

2210
Devon O'Dwyer
Guru Employee
Joshua Ordehi
Joshua OrdehiSmart Cookie
posted in API & Integrations
Issue querying Card IDs

Hello again! I've been happily querying card IDs for a few days, but now ran into this issue: > Exception: Request failed for https://api.getguru.com returned code 400. Truncated server response: { "description" : "Invalid paging token" } (use muteHttpExceptions option to examine full response) (line 36). When I follow the pagination token URL on the browser it works, logging it also gives me a working token. The call I'm making is using only the Card ID, it breaks when it has to fetch the next page, I'm using the same code from the Google Sheet you shared but only modified it so cardId is added instead of dates.

784
Joshua Ordehi
Joshua Ordehi
Joshua OrdehiSmart Cookie
asked in API & Integrations
Getting a 500 error when querying the KCS endpoint

Hello! I'm trying to query Guru's KCS endpoint to get all Zendesk tickets linked to a specific card. When I use the `cardId` query, I don't get anything back, and usually a 500 error. However, if I remove`cardId` it works, only I get ALL cards which is not what I want. I've tried `cardId` using the slug (works when doing a call to search by ID but not KCS), and also using the card id property we get in the objects when calling KCS (this also gives me ALL cards). Here's an example test in curl curl -u UNAME:TOKEN https://api.getguru.com/api/v1/kcs?cardId=CARDID This works though curl -u UNAME:TOKEN https://api.getguru.com/api/v1/cards/CARDID/extended Am I doing something wrong? We're trialing Guru for issues and feedback, but we need a way to get all ZD tickets linked to a card for it to be of any use. The Spreadsheet Guru provides is cool, but while trying to introduce the `cardId` query, it's just giving me 500 errors even if the call is properly formatted. Has anyone built something

4612
Siobhan
Charles Magnuson
Charles MagnusonKnewbie
posted in API & Integrations
Managing Jira ticket status next to link in Card

Our team lists known issues in the Guru card that covers the feature or subject the KIs fall under. For example, we have a card titled 'Inviting and managing new and existing club members' which contains information about these features along with any related known issues. Currently, the known issues are written into the card with a hyperlink to the Jira ticket. If the Jira ticket is updated or resolved, that change is not reflected on Guru until a member of the team manually edits the card. What are your recommendations for handling this? It would be wildly helpful if we could embed a custom Jira search into a card so that any updates to Jira tickets are immediately reflected in Guru. While I understand there's an API-based method available to pull Jira tickets into Guru so that each ticket is a card, but we'd like to keep multiple Jira tickets listed within a single card instead of listing them as multiple cards.

272
Charles Magnuson
Hassan Muhammad
Hassan MuhammadScholar
asked in API & Integrations
Is there a way to automatically notify the card creator when a comment is posted..

Is there a way to automatically notify the card creator when a comment is posted without having to individually tag them? This would be similar to the functionality in Google Docs.

4613
Hassan Muhammad
Siobhan
Siobhan
posted in API & Integrations
Has anyone piped any API data directly to Tableau?

Hi folks! Has anyone piped any API data directly to Tableau? I'm a bit out of my depth here and hoping to get some more info to share with some team members who have a bit more knowledge around this than I do.

1622
Siobhan
E
Eric Knudsen
asked in API & Integrations
How can I auth in python using a Collection ID and Collection token?

Hi all! Having trouble understanding how to auth in python using a Collection ID and Collection token. I don't see any example code in documentation. Anyone able to help?

912
E
Siobhan
Siobhan
posted in API & Integrations
Is there a way to use the API to track the Zendesk Copy Link?

hi there! is there a way via API to tell how many times the "Z" button has been clicked (this is on cards from synced Zendesk collections.) ?

1710
Siobhan
Nathan Anderson
Nathan AndersonKnewbie
posted in API & Integrations
How can I use the API to move Cards from one Collection to another?

Hi everyone! :wave: My team and I are doing a big organizational overhaul of our Guru instance that is going to involve changing up our collections, redoing our naming conventions, and setting up a new tagging system to make everything more scalable. I'm working on setting everything up so we can do this via the API when we're ready and am ALMOST there, but am running into some difficulties moving a card from one collection to another (with the API). Here's the JSON I'm sending to the Cards endpoint: ```//create JSON let json = { "tags":tags, "collection":{"id":collectionId}, "content": content, "shareStatus":"TEAM", "preferredPhrase":cardName };``` `collectionId` is a string, and exists in Guru. I'm getting a 200 response back from my PUT request, but the collection assigned to the card remains unchanged (all of the other elements update as expected). Is this because the card is already assigned to a Collection and a Board? Thanks for any pointers!

1174
Nathan Anderson
murray
murrayKnewbie
posted in API & Integrations
Does anyone know if it's possible to create cards with an ExternalId?

Does anyone know if it's possible to create cards *via API* with an ExternalId? And then of course, update the same card in the future using that ExternalId? I'm trying to sync knowledge from another system but the file-based approach seems inefficient and will be much more difficult to implement...

355
murray
Marcos Perez
Marcos Perez
posted in API & Integrations
Why can we see how many times a Card viewed and read in Guru but only views in the API?

Hi everyone! I have a quick question: In Guru we can see for a card how many times it was viewed and read, but the API shows only views, without this differentiation. Which is the difference?

646
Dillon Head
Marcos Perez
Marcos Perez
posted in API & Integrations
How can I get all members in a group via the API?

Hello everyone! I know we can get the groups a member is in, but can't find the way to get all the members in a group via API, which is far more efficient. Is there anything I'm not finding in the API documentation?

424
Mary Houston
A
Anonymous
posted in API & Integrations
Has anyone used the API to do month over month card creation analysis?

Has anyone used the API to do MoM card creation analysis by chance? cc @leslie

70
A
Duc Bui Minh
Duc Bui Minh
posted in API & Integrations
How can I use the API to reference a Card in another Collection?

Hi team, I am using the sync API. Is there any solutions to reference to a card in another collection? https://developer.getguru.com/docs/guru-sync-manual-api#referencing-other-cards-boards-board-groups-and-resources

113
Mary Houston
Duc Bui Minh
Duc Bui Minh
posted in API & Integrations
How can I import Boards in order using the API?

Hi team, I am working with guru-sync-manual-api. Currently, I need to import boards in order. Is there any way to support for this problem?

385
Duc Bui Minh
Kristin Fretz
Kristin FretzSmart Cookie
posted in API & Integrations
How can I leverage Guru's API to help streamline our new hire onboarding experience?

Hey all! My IT team is considering joining my rollout of Guru to streamline our new hire onboarding experience. We have Okta, JIRA, Confluence and random Slide decks, so my idea is to use Guru, JIRA, Okta and possibly a synced Confluence collection (until I can convince them to move off Confluence entirely so the full company uses Guru). They love Slack's use case that mentions Guru so if any customers or current Guru employees have best practices or can chat live with us, we'd love to know the extent of Guru's API. Thanks! :blush:

356
Kristin Fretz
Dillon Head
Dillon HeadScholar
posted in API & Integrations
Is there a way for users to suspend verification requests whenever they update Cards?

Hey folks, I've seen this question asked here a couple of times and I also asked early on in our Guru implementation. Is there a way for users to suspend verification requests whenever they update cards? To my knowledge, there's currently no way to do this. I often need to make small changes to cards and I don't want to bother the verifier with what might be a simple formatting update or sentence rewrite. To get around this, you can use the API to impersonate those users and verify articles on their behalf. Assuming you're an admin (and your org is cool with you editing the content of others), you just generate a token for the verifier of the card and then post the card content using the token. This is only worth setting up if you make a lot of small changes to other users' cards, but just figured I'd mention here in case others had similar questions.

235
Mary Houston
Kristin Fretz
Kristin FretzSmart Cookie
posted in API & Integrations
Is it possible to auto-create a templated Card when something changes on a Salesforce record?

Hello Guru! Is it possible to auto-create a Guru card (using a Guru template) when something changes on a Salesforce record? I'm curious if there is a way to automate a "new merchant onboarding" Guru card after an Opportunity field in Salesforce is updated to closed won. Appreciate any insights!

2913
Donovan Watts
Jonathan Aykroyd
Jonathan Aykroyd
posted in API & Integrations
Can I use the API to post new Guru Cards or new Knowledge Alerts in Discord?

Hi everyone :slightlysmilingface:, I hope y'all are having a great week so far. Our team is considering migrating part of their support operations to Discord (from Slack). I've been able to implement a Discord bot integration to handle searching guru cards, but I cannot find any functionality in the API that lets me listen to when *new cards* get created, or when *knowledge alerts* get sent out. Is there no way to do this using the current API? Our goal is to retain the most important functionality for us from the slack integration (namely searching and linking cards, setting up a new card feed and getting verify/knowledge alerts) when moving over to Discord. Is there any work around that I could use? Thanks in advance!

432
Jonathan Aykroyd
Mary Houston
Mary HoustonSmart Cookie
posted in API & Integrations
How Jon Peck from Github built a migration tool from Github into Guru using the API

Happy :fallenleaf: Autumnal Equinox :fallenleaf: - Time to give gratitude and start fresh! In the spirit of fresh starts, why not start that custom sync project you have been wanting to do :eyes:? Jon Peck from GitHub recently shared with us how he built a *reusable migration tool from their Sales Enablement team's GitHub repository into Guru*. His initial MVP took *~2 days* and he also posted his Github to Guru action for the Guru Community to use! Since building this sync, Guru has given his team a single place where they can store and maintain all reference material relevant to their sales process. Learn more about Jon's project here. Do you have any external content sources that you want to sync into Guru but are not currently available via the Knowledge Sync feature? Are there any roadblocks in using Guru's API to build that sync for you and your team? Feel free to share in the thread!

601
Mary Houston
R
Ruairi MurphyKnewbie
posted in API & Integrations
Using the API to pull all Cards from Guru but getting a time out error

Hey folks, we're trying to leverage the API to pull all cards in our knowledge base as we're building a find&replace MVP. We're using the search endpoint with a blank query to list all cards but it appears to be timing out. It stops printing at 8952 cards and that figure doesn't appear to bear any significance. Would you be able to shed any light on why that might be the case? I'll thread the code for reference.

535
R
Geoff Richardson
Geoff Richardson
posted in API & Integrations
Option to have the API response paging link as an element within body of response

Is there an option to have the API response Paging link as an element within the Body of the response, rather than within its header? I cannot access the response header from within Power BI (or more specifically, from within Power Query), so quite a lot of the APIs capabilities are unusable to me. 

2083
Mary Houston
kelly
kellyScholar
posted in API & Integrations
Is anyone using the API to sync JIRA into Guru?

Hey all! is anyone api-ing JIRA into their guru instance? We are looking to have a single source of truth in regards to product information!

435
kelly

Badge winners

See all badges
Terms & ConditionsCookie settings