chat.bsky.convo.getUnreadCounts
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "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.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"unreadAcceptedConvos": {
"description": "Number of unread, unlocked accepted convos. Counts convos with unread messages and unread join requests. Capped at 100, where 100 means more than 99.",
"type": "integer"
},
"unreadRequestConvos": {
"description": "Number of unread, unlocked request convos. Includes convos with unread messages, but not with unread join request, since only the owner of a group has join requests to read, and the group would necessarily be accepted. Capped at 100, where 100 means more than 99.",
"type": "integer"
}
},
"required": [
"unreadAcceptedConvos",
"unreadRequestConvos"
],
"type": "object"
}
},
"parameters": {
"properties": {
"includeGroupChats": {
"default": true,
"description": "When false, group convos are excluded from the counts.",
"type": "boolean"
}
},
"type": "params"
},
"type": "query"
}
},
"id": "chat.bsky.convo.getUnreadCounts",
"lexicon": 1
}
Metadata
- DID
-
did:plc:4v4y5r3lwsbtmsxhile2ljac - CID
-
bafyreibuu7abhy74gxfprerxpiimjit43fhcrrewe43zhili7rmr4crrsi - Indexed At
- 2026-07-16 14:58 UTC
- AT-URI
-
at://did:plc:4v4y5r3lwsbtmsxhile2ljac/com.atproto.lexicon.schema/chat.bsky.convo.getUnreadCounts
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Number of conversations with unread activity for the caller. Backs the Messages tab badge.
-
Returns a page of conversations (direct or group) for the user.
-
chat.bsky.convo.updateAllRead procedure
Sets conversations from a user as read to the latest message, with filters.
-
Returns a page of incoming conversation requests for the user. Direct convo requests are returned as convoView; group join requests made by the user are returned as joinRequestConvoView.
-
A view of a conversation for moderation purposes. Unlike chat.bsky.convo.defs#convoView, it does not include viewer-specific data (such as muted, unreadCount, status, lastMessage, lastReaction), since the requester is a…