post https://{url}/v1/devices//incidents
Use the hub_url received in the registration response as your base URL.
This API requires the device to authenticate, see Device Authentication.
Open a custom incident on the device that are not covered by telemetry Incident Rules. This API allows the device to open custom incidents based on detected errors or internal state.
The device should call the Close Incident API to close the incident once the issue was resolved.
Return Data
| Name | Type | Description |
|---|---|---|
| incident_id | UUID | Unique identifier of the created incident. Should be used in the Close Incident API to close the incident once resolved. |
{
"incident_id": "3dce7586-7c40-4392-affb-f728f20bb350"
}
Notes
Incident generation will only work for claimed devices. Calling the API for unclaimed device will return successfully with a dummy incident_id.