How do I transition Incident state via the API?

Question

How do I transition Incident state via the API?  A PUT requires a new state_id, but there seems to be no way to obtain the list of permitted ids.  I've tried low integers (up to 40) but all refuse.

https://apidoc.samanage.com/#tag/Incident/operation/updateIncidentById

Thanks!

david_bond · Accepted Answer

To answer my own question…

You need to use the

https://apidoc.samanage.com/#tag/Incident/operation/updateIncidentById

's Update Incident, which requires a state_id integer to be set.  But where to get that from?  The API documentation is horribly out of date, but all the required API calls ARE available.

The important one is:

https://api.samanage.com/entity_general_info/{{solarwinds_servicedesk_incident_id}}.json?object_type=incident&action_page_type=show&is_portal_mode=false

This gets all of the available states for an Incident, including the State names and ids.  These can then be used in the "update incident" call.  Further, there are TONS of undocumented API calls, including Incident State management calls, which is great and makes SolarWinds Service Desk suitable for automation/integration.

All the available SolarWinds Service Desk API calls are now captured in the Panoramic Data SolarWinds.Api nuget package source code, which you can find here: https://github.com/panoramicdata/SolarWinds.Api/tree/main/SolarWinds.Api/ServiceDesk/Interfaces

…or if you're a .NET developer, just use the nuget, available here:

https://www.nuget.org/packages/SolarWinds.Api

Know of other undocumented API calls? Your Pull Requests are welcome.  There's a narrow window of 29 days to get them in as after that our Trial account will expire and we will be unable to maintain the package any further.