Litmus Edge Manager 3.0.x - Admin Console: Incident Settings

Get Instance Incident Settings

GET {{LEM_adminURL}}/admin/v1/config/incident-settings

Get Instance Incident Settings

Returns the instance-wide incident settings (defaults applied to incidents raised across the installation, e.g. auto-resolution behaviour).

Endpoint

GET {{LEM_adminURL}}/admin/v1/config/incident-settings

Authentication

API key in a request header (case sensitive). The value is the LEM admin API token.

URL prefix Auth header
{{LEM_URL}}/api/v1/... (main fleet API) X-AuthToken: <token>
{{LEM_adminURL}}/admin/v1/... (admin console, port 8446) X-AuthToken: <token>
{{LEM_URL}}/mpcs/... (Marketplace Catalog) Authorization: <token> (3.0.x also accepts X-AuthToken)
## Response

IncidentSettings.

Errors

HTTP status When it happens
400 Bad Request Missing or malformed query/body parameter.
401 Unauthorized Missing or invalid credentials.
403 Forbidden Token lacks permission for this operation.
404 Not Found Target entity does not exist.
5xx Service is unreachable, restarting, or internally errored. Inspect device logs under System > Support.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Response

Status: 200 OK

{
  "autoResolve": true
}

Set Instance Incident Settings

POST {{LEM_adminURL}}/admin/v1/config/incident-settings

Updated in 3.0. New optional request fields: activeIncidentTtlDays, closedIncidentTtlDays, incidentRetentionEnabled.

Set Instance Incident Settings

Updates the instance-wide incident settings.

Endpoint

POST {{LEM_adminURL}}/admin/v1/config/incident-settings

Authentication

API key in a request header (case sensitive). The value is the LEM admin API token.

URL prefix Auth header
{{LEM_URL}}/api/v1/... (main fleet API) X-AuthToken: <token>
{{LEM_adminURL}}/admin/v1/... (admin console, port 8446) X-AuthToken: <token>
{{LEM_URL}}/mpcs/... (Marketplace Catalog) Authorization: <token> (3.0.x also accepts X-AuthToken)
## Request body

IncidentSettings with the new instance-level incident configuration.

Response

ApiResponse ({ code, message }).

Errors

HTTP status When it happens
400 Bad Request Missing or malformed query/body parameter.
401 Unauthorized Missing or invalid credentials.
403 Forbidden Token lacks permission for this operation.
404 Not Found Target entity does not exist.
5xx Service is unreachable, restarting, or internally errored. Inspect device logs under System > Support.

TLS note: edge devices use a self-signed certificate by default. Either install the device CA in your client trust store or disable certificate verification when calling this endpoint directly.

Request Body

{
  "autoResolve": true,
  "activeIncidentTtlDays": 90,
  "closedIncidentTtlDays": 90,
  "incidentRetentionEnabled": false
}

View this page as Markdown