Skip to main content

Get help

Ask and answer questions about Guru

637 Posts
Katie Vermilyea
Katie VermilyeaSmart Cookie
posted in API & Integrations
Using Guru's API to feed a dev site into Guru - any tips?

:wave: Hey all! I'm trying to convince my Engineering and Product Teams that we should use the *Guru Manual API to feed our new Dev site into Guru.* Did anyone have any winning arguments that helped make the case? @klecornu shared some great examples with me yesterday, so I know a few of you have done it! Would love some additional pro tips.

126
Katie Vermilyea
4 years ago
R
Ruairi MurphyKnewbie
posted in API & Integrations
Questions about automating card verification when a user adds a card URL to a specific field in Zendesk

Hey Team :wave: I'm working with one of our devs to build out an MVP for automating card verification when a user adds a card URL to a specific field in Zendesk. It's built on Rails. We've a couple of questions we're hoping you could answer. We can't find any reference to the verifier endpoint in the API docs. - Would it be possible to get an example of a POST updating a cards verifier via the `https://api.getguru.com/api/v1/cards//verifiers/` endpoint? An example in Ruby would be amazing, but curl would be fine too. - What are the required fields for this request? - We're also wondering if it's possible to update the verification interval without also having to "update" the `preferredPhrase` or content by sending the same current value? Our previous MVP used the `https://api.getguru.com/api/v1/facts//extended` endpoint but we'd like to work around updating the title/content with every request. Can you recommend an alternative?

145
R
4 years ago
Geoff Richardson
Geoff Richardson
posted in API & Integrations
Is it possible to get a list of all users who have modified a Card?

Another question about API responses. Does anyone know whether it's possible to get a list structure of ALL users who have modified a card, rather than just the record of the *last* person to modify it? I'm keen to understand the full audit trail of a card's history. Thank you!

633
Geoff Richardson
4 years ago
Geoff Richardson
Geoff Richardson
posted in API & Integrations
Search API query not returning archived Card details

Hi team, I think that I have found a bug in the API. I am using the search/query with success in our code. I have noticed that it *doesn't* return any archived card details when we use the simple `q` query parameter. I know that there is another query parameter called `showArchived` which takes true or false. When I set this extra parameter to true, then it *only* returns archived cards: that's correct behavior. When I set it to false, it *only* returns non-archived cards: that correct behavior. However, when I *omit* the `showArchived` parameter, I believe that it should return BOTH archived and non-archived cards. Unfortunately, this is not the case. It does not return any archived cards. Please can you investigate? If this behavior is intentional, how am I supposed to return both archived and non-archived cards without making two separate API calls…? Thank you :slightlysmilingface:

352
Geoff Richardson
4 years ago
A
amararepsKnewbie
posted in Q&A
How do you collect proof of reading Cards?

Not sure if someone has already said this. My HR person is wanting me to use Trainual in addition to Guru (or instead of). The reason being is that she wants us to use Trainual for our employee handbook so that people can sign off on having reviewed different aspects of it. Does Guru do this or is there anything on the roadmap to have people sign off on having reviewed cards? I need to document that policies have been reviewed somehow. I COULD work around it... but it would be a bit cumbersome. Any ideas? Thanks!

255
A
4 years ago
R
Ruairi MurphyKnewbie
posted in API & Integrations
Questions about using Guru's API to update a Card's verifier

Hey folks, first time caller long time fan :wave: We're in the process of adapting how one of our teams verifies content in Guru to more closely align with our KCS methodology. We've built an MVP where once a card has been added to a custom field in Zendesk and the ticket is submitted, we catch the hook, get the card ID from the Guru URL, and once it passes our validation, use PUT to update the card's verifier. We want to be able to set the verifier of the card as the ticket submitter, verify said card, and set its verification interval to 90 days. The MVP is functioning as expected but we've hit a roadblock with API credentials. The issue is that AFAIK we don't have a general or admin API token with read/write access. The collection API token would work for our use case, but they're read-only. As a result, while we can assign the card to the SME who submits the ticket, we can't set the verification status to trusted. Without the ability to do so its purpose is defeated. Any suggestion

729
Mary Houston
4 years ago
I
Ian Herzing
asked in Q&A
I'm wondering if an SOP or a best practice exists on "How to write a good Guru card?"

Hi friends! I was wondering if an SOP exists for a best practice on "*How to write a good Guru Card*". In short, we are running into a situation in which employees are creating cards and just throwing links to other documentation within the card without clear explanation of what that link even is in the first place. Thanks!

764
I
4 years ago
kelly
kellyScholar
posted in API & Integrations
Workflow to add a task directly from Slack to create a Card with "XYZ" information?

hi - add a task directly from slack to create a card with XYZ information :tada:

246
kelly
4 years ago
Brianna Zoffka
Brianna ZoffkaSmart Cookie
asked in Q&A
How to bulk upload/create cards by CSV?

have you guys ever thought about implementing a bulk upload feature via csv? for instance, we just launched a new product and have tons of FAQ's that we are putting in one by one. i would love to have been able to put those in a sheet and upload. i could then fill in the context if necessary. this also came up with our CSM team. they all worked as a group to put together plays for objection handling but they were all built together outside of guru. so they then had to put them in guru but wished to be able to bulk upload

2483
Priya Ranganath
4 years ago
Ali Berman
Ali BermanScholar
posted in API & Integrations
How can I pipe unverified Cards into a Slack channel?

Hi! I have an API question! I want to set up a way to pipe super duper old & dusty unverified cards into a Slack channel using Workato. In theory I can do this if I can update a Google spreadsheet using API calls, but that's where I'm getting stuck. Right now, I use the Card Manager to look a set of parameters to pull it manually - but I'd like to take myself out of the process and operationalize this process! Has anyone done anything similar to this?

233
Mary Houston
4 years ago
A
Anonymous
posted in API & Integrations
Guru the Gathering resources - Extending Guru through the API

• More info. on the Guru Developer Network, including API documentation, how to sign up for a developer account, and examples of how others are using the API: https://www.getguru.com/developers • Deck from today: https://app.getguru.com/card/crkRA9Xi/121819-Virtual-Guru-the-Gathering-online-Extending-Guru-through-the-API • Questions for @mhouston about the API and/or Guru Developer Network? Feel free to reach out here in Slack, or via email:

150
A
5 years ago

Badge winners

See all badges
Terms & ConditionsCookie settings