Notifications
List notifications
The notifications in the bell of the broker your key acts as, newest first. A teammate's notifications are never included.
query Parameters
page1-indexed page number, up to 1000000.
page_sizeRows per page. Capped at 100.
unread_onlySend true to return only unread notifications.
updated_sinceISO 8601 date-time, for example 2026-10-01T00:00:00Z. Returns only notifications that arrived or were read at or after it. A value that is not ISO 8601 gets 400 VALIDATION_ERROR.
List notifications › Responses
Success
successAlways true on a successful response.
The page of results. The endpoint description and the Pagination guide give the order.
Offset pagination. Page forward until page reaches total_pages.
Mark a notification read
Marks one notification read. A notification that is already read keeps the time it was first read. Reading a mention also marks the mention seen.
path Parameters
idResource id.
Headers
Idempotency-KeyOptional for POST. An authorized retry with the same method, path, and exact body returns the stored response. Reservations last 24 hours. They belong to the original API key and broker. Reconcile uncertain results before you use a new key.
Mark a notification read › Responses
Success
successAlways true on a successful response.
The requested record.
Mark every notification read
Marks every unread notification of the broker read, and returns how many it marked.
Headers
Idempotency-KeyOptional for POST. An authorized retry with the same method, path, and exact body returns the stored response. Reservations last 24 hours. They belong to the original API key and broker. Reconcile uncertain results before you use a new key.
Mark every notification read › Responses
Success
successAlways true on a successful response.
The requested record.