---
updatedAt: 2026-05-07T19:52:13.000Z
agentTools:
  projectIndex: https://dev.xyte.io/llms.txt
---

# Incident Management

# Overview

The Xyte platform tracks three types of Incidents on a Device:

1. **Rule-based** — created automatically when a Rule matches Device Telemetry. See [Incident Rules](https://dev.xyte.io/docs/rules).
2. **End Customer** — opened manually by an End User in the Customer Portal.
3. **Device-initiated** — opened by the Device itself via the [Open Incident API](https://dev.xyte.io/reference/create-incident).

<br />

## Device-initiated incidents

Use Device-initiated Incidents to surface internal errors or warning states the Device detects locally. Reporting these to the server gives the End Customer a clearer picture of the Device's health than Telemetry alone.

<br />

The following APIs are available:

1. [Open Incident](https://dev.xyte.io/reference/create-incident) — open a new Incident on the Device.
2. [Close Incident](https://dev.xyte.io/reference/close-incident) — close an End Customer or Device-initiated Incident.
3. [Get Incidents](https://dev.xyte.io/reference/get-incident) — list the open Incidents on a Device.
4. [Close Incidents](https://dev.xyte.io/reference/close-incidents) — clear all Device-initiated Incidents after a reboot or re-registration.