Important information about accessing the API
This page describes our REST API 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.
In the first release of 2024 we rolled out Next-Insight REST API v.2 which extends the initial with new endpoints related to Value Streams, Business Processes and much more. As new endpoints have been rolled out, the endpoints from v.1 of the API will be marked deprecated and we encourage everyone to switch to v.2 within a reasonable timeframe. We will support older API versions, where newer versions are available, until the end of Q3.
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.
Information Object REST API documentation – version 2.0:
Retrieve and set the Information Objects in your Next-Insight installation. This API has “upsert” protection to prevent Information Objects being updated if nothing has changed, so it’s safe to schedule all Information Objects to be updated, and the API will figure out what to update.
Organisation REST API documentation – version 2.0:
Retrieve and set the Organisations in your Next-Insight installation. This API has “upsert” protection to prevent Organisations being updated if nothing has changed, so it’s safe to schedule all Organisations to be updated, and the API will figure out what to update.
Group REST API documentation – version 2.0:
Retrieve and set the Groups in your Next-Insight installation. This API has “upsert” protection to prevent Groups being updated if nothing has changed, so it’s safe to schedule all Groups to be updated, and the API will figure out what to update.
Person REST API documentation – version 2.0
Retrieve and set the People in your Next-Insight installation. 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.
Capability REST API documentation – version 2.0:
Retrieve and set the Capabilities in your Next-Insight installation. This API has “upsert” protection to prevent Capabilities being updated if nothing has changed, so it’s safe to schedule all Capabilities to be updated, and the API will figure out what to update.
Process Domain REST API documentation – version 2.0:
Retrieve and set the Process Domains in your Next-Insight installation. This API has “upsert” protection to prevent Process Domains being updated if nothing has changed, so it’s safe to schedule all Process Domains to be updated, and the API will figure out what to update.
Value Stream REST API documentation – version 2.0:
Retrieve and set the Value Streams in your Next-Insight installation. This API has “upsert” protection to prevent Value Streams being updated if nothing has changed, so it’s safe to schedule all Value Streams to be updated, and the API will figure out what to update.
Value Stream Stage REST API documentation – version 2.0
Retrieve and set the Value Stream Stages in your Next-Insight installation. This API has “upsert” protection to prevent Value Stream Stages being updated if nothing has changed, so it’s safe to schedule all Value Stream Stages to be updated, and the API will figure out what to update.
Business Process REST API documentation – version 2.0:
Retrieve and set the Business Processes in your Next-Insight installation. This API has “upsert” protection to prevent Business Processes being updated if nothing has changed, so it’s safe to schedule all Business Processes to be updated, and the API will figure out what to update.
Product REST API documentation – version 2.0:
Retrieve and set the Products in your Next-Insight installation. This API has “upsert” protection to prevent Products being updated if nothing has changed, so it’s safe to schedule all Products to be updated, and the API will figure out what to update.
Geography REST API documentation – version 2.0
Retrieve and set the Geographies in your Next-Insight installation. This API has “upsert” protection to prevent Geographies being updated if nothing has changed, so it’s safe to schedule all Geographies to be updated, and the API will figure out what to update.
Software REST API documentation – version 2.0
Retrieve and set the Softwares in your Next-Insight installation. This API has “upsert” protection to prevent Softwares being updated if nothing has changed, so it’s safe to schedule all Softwares to be updated, and the API will figure out what to update.
Technology Component REST API documentation – version 2.0:
Retrieve and set the Technology Component in your Next-Insight installation. This API has “upsert” protection to prevent Technology Components being updated if nothing has changed, so it’s safe to schedule all Technology Components to be updated, and the API will figure out what to update.
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.