Skip to main content

​
List Notifications

Returns the notification feed for the authenticated user’s organization. 
GET /api/notifications

​
Response

[
  {
    "id": "notif_01hx...",
    "type": "device.enrolled",
    "message": "A new device \"alice-macbook-pro\" was enrolled",
    "read": false,
    "created_at": "2025-10-14T17:00:00Z"
  }
]
FieldTypeDescription
idstringNotification ID
typestringEvent type (see below)
messagestringHuman-readable notification text
readbooleanWhether the user has marked it as read
created_atstringISO 8601 timestamp

​
Notification Types

TypeDescription
member.joinedA member accepted an invitation
device.enrolledA device was enrolled
device.disabledA device was disabled
billing.updatedA billing event occurred
threat.alertA threat detection threshold was exceeded

​
Mark as Read

Marks a single notification as read. 
POST /api/notifications/:id/read

​
Response

200 OK

​
Mark All as Read

Marks all notifications in the feed as read. 
POST /api/notifications/read-all

​
Response

200 OK