Notifications
Base path: /api/v1/notifications (authenticated). Notifications are sealed audit-adjacent and surface in the dashboard bell.
My notifications
Section titled “My notifications”| Method · Route | Purpose |
|---|---|
GET / | Recent notifications (org-announcement attachments included) |
GET /unread-count | Unread count (bell badge) |
PATCH /{id}/read | Mark one of your own notifications read. Someone else’s, a deleted one, or an unknown id all return 404 |
PATCH /read-all | Mark all read |
DELETE / | Delete your own notifications by id list. Body { "ids": [...] }; returns { "deleted": n } |
Org announcements (Owner / Admin)
Section titled “Org announcements (Owner / Admin)”| Method · Route | Purpose |
|---|---|
POST /org/send | Broadcast to all members, or target specific RecipientConnectedIds; category="Org" (Owner/Admin only). Each attachment’s Url must be one returned by /org/attachments for this org; any other URL returns 400 invalid attachment |
POST /org/attachments | Step 1 of a 2-step upload — upload a file, get its metadata back (Owner/Admin only) |
GET /org/attachments/{attachmentId}/download | Authenticated download — only the announcement’s recipients or the org’s Owner/Admin |
Attachments are grouped under one AnnouncementId (a single announcement fans out to many recipient rows). Notification types/categories feed the Events catalog.