List Engines API (classic)

Overview

The List Engines API lets you programmatically retrieve the connection status and details of all the Engines linked to Portal.

The client of the List Engines API must trust the certificate in the primary Appliance (Portal).

To authenticate the client, the List Engines API uses Basic Authentication. Nexthink recommends creating a local account to exclusively authenticate clients of the API.

Authentication

User account

To authenticate the client, the List Engines API supports Basic Authentication. Nexthink recommends creating a local account to exclusively authenticate clients of the API.

OAuth

You can configure Nexthink to grant access to the List Engines API using the open standard for access delegation, OAuth. Contact Nexthink Support for more information.

Querying the API

User account

To query the List Engines API, send the following GET request without parameters to Portal:

https:///api/configuration/v1/engines

Substitute <Portal_DNS_FQDN> with the actual name of Portal.

OAuth

To query the List Engines API, send the following GET request without parameters to Portal:

https://agora.<region>.nexthink.cloud/api/configuration/v1/engines

Where <region> must match the region of your Nexthink Experience platform, as assigned to your organization during the onboarding.

The Enrichment API is currently available for the following regions:

  • eu

  • meta

  • pac

  • us

Output of the List Engines API

The data that you can retrieve from the List Engines API is similar to what you get from the Engines dashboard when you connect Portal to the Engines.

The output holds the list of Engines in JSON format. For each Engine, find:

Output dataDescription

name

The name of the Engine

databaseUID

The UID of the Engine database

machineID

The ID of the machine that runs the Engine

description

The description that the administrator gave to the Engine when connected .

status

The status of the connection between Portal and the Engine:

  • CONNECTED

  • DISCONNECTED

  • CONNECTING

address

The IP address of the Engine

port

The TCP port number where the Engine listens for the connection of Portal.

timezone

The time zone configured in the Engine.

version

The version number of the Engine.

Last updated

#451: 2024.8-Overview of integration DOC

Change request updated