Check the Lumana allow list from a Core

Asks the Core to try each host and port Lumana needs and returns which ones it could reach. This is the check to run when a Core is online but a specific feature is not working — the device has general connectivity, yet one destination is blocked by the site firewall. The list of destinations is decided by the Core software, not by this request. To read the Lumana addresses a customer has to allow through their firewall, use GET /v1/network/get-ip-addresses. The command is published to the Core and the HTTP response is held open until the device answers. On success the body is the device's own output merged with sessionId and state. state is a NUMBER, not a word - 0 completed, 1 the device did not answer in time, 2 the device reported an error, 3 the command was not sent because the Core was out of sync. A call that times out answers 408 with { message, state: 1, responseBody } and carries NO sessionId and no device output. The shape of the device output depends on the Core software version and is passed through untouched, so treat it as free-form diagnostic data rather than a fixed schema.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Id of the Core to run the diagnostic on. It must belong to the organization the credential authenticates as; a Core of another organization is reported as not found. The location is resolved from the Core itself, so there is no locationId parameter.

Responses

400

The request body is invalid. The response names the field to correct.

401

Unauthorized. Missing or invalid credentials.

404

No such Core in this organization. Returned both for a Core id that does not exist and for one that belongs to another organization.

408

The Core did not answer within 120 SECONDS, after which the call answers 408 Request Timeout and the command may still complete on the device. The body is { message: "Request Timeout", state: 1, responseBody } — no sessionId and no device output. This usually means the device is offline or has lost its connection to Lumana.

500

The diagnostic could not be dispatched, or the Core answered with an error. The body carries state: 2 (error) and the device message when there is one.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json