Alerts
Tools for monitoring and managing device alerts. Alerts are generated automatically when monitored conditions trigger — for example, when a device goes offline, encounters a content error, or exceeds resource thresholds.
list_alerts
List alerts for the account. Returns alert objects with id, device reference, status (active/resolved), timestamps, and alert details.
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id |
string or string[] | No | Filter by device ID(s) |
active_only |
boolean | No | Return only active (unresolved) alerts |
resolved |
boolean | No | Include resolved alerts |
org_id |
string | No | Filter by organization ID (multi-org accounts) |
take |
number | No | Results per page |
page |
number | No | Page number (1-based) |
get_alert
Get detailed information about a specific alert including type, associated device, trigger condition, timestamps, and resolution status.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The alert ID |
update_alert
Update an alert’s status — typically to mark it as resolved or acknowledged.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The alert ID |
resolved |
boolean | No | Set to true to mark as resolved |