Notifications

Manage in-app notifications. Notifications are generated by system events such as completed ingestions, metric computation results, or webhook delivery failures. Use these endpoints to list, read, and manage your notification feed.

Use cases

  • Activity feed โ€” display a chronological feed of system events in your application
  • Status tracking โ€” check for completed or failed tasks without polling individual endpoints
  • Housekeeping โ€” mark notifications as read or delete them to keep your feed clean

Endpoints

MethodPathDescription
GET/notificationsList notifications with filtering and pagination
GET/notifications/:idGet a specific notification
PATCH/notifications/:id/readMark a notification as read
PATCH/notifications/readBulk mark notifications as read
DELETE/notifications/:idDelete a notification

Required scope: notifications:read for viewing, notifications:write for marking read and deleting