social.colibri.beta.channel.putReadCursors
Pushes the requesting user's read cursors for one community to the AppView, so unread counts update immediately instead of waiting for a sync notification. The client writes its social.colibri.beta.channel.read record for the community to its own personal space first, then calls this. Clients should debounce this rather than calling it on every message. The user's other sessions receive the cursors that moved as a social.colibri.beta.sync.defs#readCursorEvent.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | channel.beta.colibri.social |
| Indexed |
Procedure
procedure · POSTInput
application/jsonThe community the cursors belong to.
Read cursors for the community's channels and threads. Each one replaces the stored cursor only when it is newer, and channels left out keep their stored cursor.
Output
application/jsonUnread state per channel, after the update.
Errors
AuthRequired
The request has no valid service auth.
CommunityNotFound
No community matches the given DID.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Read state for one community's channels. The record key is the community DID, which bounds each record to a community's channel count and makes leaving a community a single delete.
-
Lists per-channel unread state for the requesting user.
-
Lists the unread status of every channel in a community for the authenticated user.
-
Returns the authenticated user's read cursor for a channel.
-
social.colibri.channel.read
recordA read cursor for a Colibri channel, indicating the last read message by a user.