social.colibri.beta.notification.clear

Clears the requesting user's inbox up to a point in time. Every notification raised at or before it is marked seen and left out of listNotifications, getUnreadCount and getUnseen from then on.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority

Details · procedure

Kind	procedure
Authority	notification.beta.colibri.social
Indexed	24d ago · 2026-10-17

Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

clearedAt

requiredstring · datetime

Notifications raised at or before this time are cleared. A time in the future is treated as now, and a time before an earlier clear leaves that clear in place.

Output

application/json

clearedAt

requiredstring · datetime

The point the inbox is now cleared up to.

unread

requiredinteger

Number of unread notifications remaining.

Errors

AuthRequired

The request has no valid service auth.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

social.colibri.beta.notification.updateSeen
procedure

Marks every notification raised at or before a point in time seen.
social.colibri.beta.notification.getUnreadCount
query

Gets how many of the requesting user's notifications are unread.
social.colibri.notification.updateSeen
procedure not from the namespace authority

Marks all notifications up to a timestamp as seen.
social.colibri.notification.getUnreadCount
query not from the namespace authority

Returns the count of unread notifications.
site.mochott.notification.updateSeen
procedure

Mark notifications of the requesting account as read. Requires auth.