Send notification
Delivers an inbox notification to the specified recipient. The notification is persisted and, if the recipient is online, pushed in real time via the WebSocket gateway. Supports idempotency via the Idempotency-Key header — duplicate requests within the retention window return the original response. Optionally attach a topicId to associate the notification with a subscription topic for preference-based filtering.
Authorization
environmentKey In: header
Response Body
curl -X POST "https://loading/v1/server/notifications"Put recipient PUT
Full-replacement upsert keyed by the `{recipientId}` path segment. If the recipient exists, its profile is replaced entirely with the provided fields. If it does not exist, a new recipient is created. This endpoint is idempotent — repeated calls with the same body produce the same result.
List notifications GET
Returns a paginated list of notifications for the authenticated recipient. Filter by `status` (all, unread, read, archived), `type`, or `topicId`. Use `cursor` for keyset pagination. Results are ordered by creation time descending, newest first.