JSON API Interface

Important information about accessing the API

This page describes our API interface for Next-Insight. The links below only work if you are previously logged into Next-Insight – if you get an error clicking the links, make sure to login first. 

As of Release Q1.2041 we have rolled out a new version of Next-Insight API with an expansion of endpoints for Types starting with Applications and Integrations. As new endpoints have been rolled out, the endpoints from version 1 of the API will be marked deprecated and we encourage everyone to switch to the new one within a reasonable timeframe. We will support older API versions, where newer versions are available, until the end of Q3

Next-Insight Version 2:

Application REST API documentation – version 2.0: 

Retrieve and set the Applications in your Next-Insight installation. This API has “upsert” protection to prevent Applications being updated if nothing has changed, so it’s safe to schedule all Applications to be updated, and the API will figure out what to update. 

Integration REST API documentation – version 2.0 

Retrieve and set the Integrations in your Next-Insight installation. This API has “upsert” protection to prevent Integrations being updated if nothing has changed, so it’s safe to schedule all Integrations to be updated, and the API will figure out what to update. 

Next-Insight Version 1:

Person REST API documentation – version 1.3
Retrieve the people in your Next-Insight installation with ADGuids with the list operation. The ADGuid is a key that can be used to update the records afterwards with the set operation. If the ADGuid is matched the person is updated, otherwise a new person is created.
This API has “upsert” protection to prevent people being updated if nothing has changed, so it’s safe to schedule all people to be updated and the API will figure out what to update.

Application REST API documentation – version 1.2
Retrieve and set the Applications in your Next-Insight installation. This API has “upsert” protection to prevent Applications being updated if nothing has changed, so it’s safe to schedule all Application to be updated, and the API will figure out what to update.

Group REST API documentation – version 1.0
Retrieve, set and delete the Groups in your Next-Insight installation.

Organisation REST API documentation – version 1.0
Retrieve and set the Organisation elements in your Next-Insight installation.

Server REST API documentation – version 0.5
Retrieve and set the Server elements in your Next-Insight installation. Servers can be related to Applications with a list of Application External IDs, and to SoftwareInstances by name.

SoftwareInstance REST API documentation – version 0.1
Retrieve, set, and delete the Software instances in your Next-Insight installation.