Skip to content

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.

Operations

Retrieve security and operational events for a specific node

Request

List events for a node (appliance or agent), newest first

Requires alerts::read permission.

Security
JWTAuthorizer
Path
nodeIDstringrequired

Node ID

curl -i -X GET \
  'https://apidocs.trustgrid.io/_mock/alert/{nodeID}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
Array [
alert_messagestring

More information about the alert

Example:"Node mynode abnormally disconnected"
nodestring

Node name that generated the alert

Example:"mynode"
node_idstring

Node ID that generated the alert

Example:"19084f81-5668-41ee-adbe-295e4c65531a"
timestampnumber

Unix timestamp of alert

Example:1661440360
typestring

Type of alert

Example:"Data Plane Disruption"
uidstring

Unique ID of alert

Example:"2DqxLdknjWxEkGt474d2Cstsa1O"
]
Response
[
  {
    "alert_message": "Node mynode abnormally disconnected",
    "node": "mynode",
    "node_id": "19084f81-5668-41ee-adbe-295e4c65531a",
    "timestamp": 1661440360,
    "type": "Data Plane Disruption",
    "uid": "2DqxLdknjWxEkGt474d2Cstsa1O"
  }
]