Notifications
Endpoints
Every notifications route at a glance.
All routes require an Authorization header (the stream also accepts
?access_token=). Notifications are account-level — no X-Workspace-Id
header anywhere in this section.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/notifications/ | List your feed (paginated, filterable) |
| POST | /v1/notifications/{notification_id}/read | Mark one read |
| POST | /v1/notifications/mark-all-read | Mark everything read |
| GET | /v1/notifications/stream | Live stream (Server-Sent Events) |
| GET | /v1/notifications/channels | List channel endpoints |
| POST | /v1/notifications/channels | Create an endpoint |
| PUT | /v1/notifications/channels/{channel_id} | Update an endpoint |
| DELETE | /v1/notifications/channels/{channel_id} | Delete an endpoint |
| POST | /v1/notifications/channels/{channel_id}/test | Send a test message |
| GET | /v1/notifications/preferences | Get your preferences |
| PUT | /v1/notifications/preferences | Update your preferences |
| GET | /v1/notifications/preferences/catalog | The event catalog |