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
| Method | Path | Description |
|---|---|---|
| GET | /notifications | List notifications with filtering and pagination |
| GET | /notifications/:id | Get a specific notification |
| PATCH | /notifications/:id/read | Mark a notification as read |
| PATCH | /notifications/read | Bulk mark notifications as read |
| DELETE | /notifications/:id | Delete a notification |
Required scope:
notifications:readfor viewing,notifications:writefor marking read and deleting