# Alert

Security and operational events broadcast when significant node or system activity occurs (connects/disconnects, certificate warnings, order updates). Required permissions vary by endpoint; see each operation description for the specific permission needed.


## Retrieve security and operational events for a specific node

 - [GET /alert/{nodeID}](https://apidocs.trustgrid.io/alert/listnodealerts.md): List events for a node (appliance or agent), newest first

---

Requires alerts::read permission.

## Retrieve all recent security and operational alerts across the organization

 - [GET /v2/alert](https://apidocs.trustgrid.io/alert/listalertsv2.md): Requires alerts::read permission.

## Retrieve security and operational alerts specific to a single node

 - [GET /v2/alert/{nodeID}](https://apidocs.trustgrid.io/alert/listnodealertsv2.md): Requires alerts::read permission.

## Manually resolve and dismiss a specific alert type for a node

 - [DELETE /v2/alert/{nodeID}/{alertType}](https://apidocs.trustgrid.io/alert/paths/~1v2~1alert~1%7Bnodeid%7D~1%7Balerttype%7D/delete.md): Requires alerts::read permission.

## List audit events across the organization filtered by time range and type

 - [GET /v2/event](https://apidocs.trustgrid.io/alert/listevents.md): Returns a paginated list of audit events (node connects/disconnects,
config changes, certificate warnings, order updates, etc.) within a
time window. Supports filtering by node, event type, level, and item
type. Use sTime/eTime for the time range (ISO 8601).

---

Requires events::read permission.

## Get all events by time range for a Node

 - [GET /v2/event/{nodeId}](https://apidocs.trustgrid.io/alert/listnodeevents.md): Requires events::read permission.

## Validate if a specific event would trigger configured alarm filters

 - [POST /v2/event/{nodeId}/{eventId}](https://apidocs.trustgrid.io/alert/paths/~1v2~1event~1%7Bnodeid%7D~1%7Beventid%7D/post.md)

## List all security and operational events across the organization (deprecated)

 - [GET /alert](https://apidocs.trustgrid.io/alert/listalerts.md): This is deprecated; use /v2/event instead.

---

Requires alerts::read permission.