chat.bsky.convo.getUnreadCounts

bsky-lexicons.bsky.social

{
  "$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
}

Validate Record

Validate a record against chat.bsky.convo.getUnreadCounts

Validation Options
Treat any remaining unresolved references as valid

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.

  • 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…

Lexicon Garden

@