chat.bsky.convo.listConvos

Returns a page of conversations (direct or group) for the user.

Details · query
Kindquery
Authorityconvo.bsky.chat
Indexed

Query

query · GET

Parameters

query string

cursor

string

kind

string

Filter by conversation kind.

  • knownValues: direct | group

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

Filter by conversation lock status. Values follow chat.bsky.convo.defs#convoLockStatus.

  • knownValues: unlocked | locked | locked-permanently

readState

string
  • knownValues: unread

status

string

Filter convos by their status. It is discouraged to call with "request" and preferred to call chat.bsky.convo.listConvoRequests, which also includes group join requests made by the user.

  • knownValues: request | accepted

Output

application/json

convos

requiredarray
itemsref

cursor

string

Similar lexicons

semantic match

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