ASSIST SERVICE DESK API

wimjongman

We have contacted Goto Assist SD Support but they do not reply to our emails. 

We need to figure out the Goto Assist SD API. 

1. How can I filter incidents and changes based on conditions? For example, I know that a change has a title that contains the words "set up" and has priority "Important" so I want to query for the changes that have these words in their title and have important priority so the query must be something like this:
   
   title="set up" AND priority="Important"
   
   What is the syntax for such a query? The ids for the filter conditions are the ones used in the properties of the entity (in this case change_properties)? As for the values, which fields can be searched with a string, and which have to searched by ID only? In this case it must be priority=3 using the priority id?
   
   
2. I saw that you can filter by service using a query param like this: filter[service]=/services/{{serviceId}} so I tried something like filter[change]=/changes/title/set up.
   but I get an error code E24 back with message "Property change cannot be filtered on". If a filter query param has to be used I would like to know the syntax and the available  values for basic filtering please.
   I have also tried using a property as a direct query param, for example title=set up but then it returns always all results ignoring filtering.
   
   
3. How can the filtering of changes based on service be combined with any other attribute filtering like title, priority, status etc?
   
   
4. If I want to make a query searching for changes that have a text inside their sections, for example to search in the plan section of a change, in its description field, how is that possible? I see that when it comes to sections, the value returned in the change entity is an ID like
   "description": "/notes/2314551141891621081" for the plan description or
   "build_instruction": "/notes/2314551141891621084" for the build instruction in the build section and those IDs can be used to query the notes entity so that you can get the entire section back as a note entity. How do I query changes that have a specific text inside a section without having to query the sections beforehand?
   
   
5. In the web, reports are most commonly used for filtering. I don't see any API REST end points for getting reports. Are they not supported? If they are, can they be used to query incidents and changes and as a filtering parameter to pass only the report ID? That would be useful to use the reports that a client has already created in the web as filters.
   
   
6. Is it possible to create custom fields in incidents and changes (preferably in the first default section) through the API? How is it possible afterwards to query for incidents/changes that have a specific custom field (key: value)?
   
   
7. How can I create and delete tags on incidents and changes and how to query incidents/changes later based on one or many tags?

KateG

Hi @wimjongman 

I see that you were in contact with a consultant. For quicker assistance, please reach out to dev support directly. You should email: developer-support@goto.com. They are best equipped to address these inquiries and can provide you with the support needed.