EaserixDocs
DevelopersAPI referenceNotificationsFeed

Live unread stream (SSE)

A Server-Sent Events stream of the caller's unread count for the active org. The connection emits `data: {"unread": N}` immediately on connect and again whenever a new feed row lands, plus `: ping` heartbeat comments. The client updates its badge and refetches the feed on each data event. One-way and stateless by design — any replica can serve any client. Product notifications reach the feed asynchronously via the platform event outbox (eventkit), not a direct call to this service.

View as Markdown
GET
/v1/stream

Authorization

bearer
AuthorizationBearer <token>

In: header

Response Body

text/event-stream

application/json

application/json

curl -X GET "https://example.com/v1/stream"
"data: {\"unread\": 3}"

Clear the badge

Marks every unread item in the active org read.

Category preferences

The full matrix of known categories. Absence of a stored row means enabled, so a new category starts on for everyone without a backfill.