chat.bsky.convo.listConvos

#main

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

Parameters

Property	Type	Known Values	Required	Description
limit	integer	-	❌	-
cursor	string	-	❌	-
readState	string	unread	❌	-
status	string	request accepted	❌	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.
kind	string	direct group	❌	Filter by conversation kind.
lockStatus	string	unlocked locked locked-permanently	❌	Filter by conversation lock status. Values follow chat.bsky.convo.defs#convoLockStatus.

Output

• Encoding: application/json

Property	Type	Known Values	Required	Description
cursor	string	-	❌	-
convos	array of chat.bsky.convo.defs#convoView	-	✅	-