Lexicon Garden

fyi.opensocial.getUnread

What's new for the caller in each tab that says what's new in it (its news), in every group on this host they're in: when someone else last added something there, and how much there is for them that they haven't seen. Whether the newest is new to them is theirs to say, from how far they've read, which only they keep.

Repository @lexicons.opensocial.fyi did:plc:2gqnilpksz2e7faj3bwvo6qc namespace authority
Details · query
Kindquery
Authorityopensocial.fyi
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

group

string · did

That group's only.

Output

application/json

groups

requiredarray
itemsref
Reference

#groupUnread

object

Properties

group

requiredstring · did

joinedAt

requiredstring · datetime

When the caller joined: in a place they've never read, what came after it is new.

places

requiredarray
itemsref
Reference

#placeUnread

object

Properties

channel

requiredstring

The channel's slug.

forYou

requiredinteger

How many things there that answer something of the caller's, or name them, they haven't seen.

  • minimum: 0

newest

string · datetime

When the host had the newest thing someone else added there.

room

string · at-uri

In a chat, the record its room is about. Without one, the space as a whole.

space

requiredstring · at-uri

tab

requiredstring

The tab's slug.

Similar lexicons

semantic match

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

  • fyi.opensocial.listNotifications

    query

    The caller's Activity, newest first, from every group on this host they're in: what answers something of theirs, what names them, and, where they asked for everything new, each new event or thread. Only what they may still read, as it is now.

  • fyi.opensocial.readState

    record

    How far you've read in one of a group's places, a chat or a board, say: kept in your own inbox, where only you read it.

  • chat.bsky.convo.getUnreadCounts

    query

    Returns unread conversation counts for conversations that are unlocked, not muted, split by convo status. Direct convos are excluded when a block relationship exists between the actor and the other member, or when the other member's account is deleted or deactivated. Group convos are considered unread if they have unread join request counts.

  • social.colibri.beta.notification.getUnseen

    query

    Gets the requesting user's unseen notifications for one channel, used to render that channel's unread badge detail.

  • fyi.opensocial.getNotificationPreferences

    query

    How much of a group reaches the caller's Activity: theirs alone.