Lexicon Garden

chat.bsky.convo.getConvoForMembers

Get or create a 1-1 conversation for the given members. Always returns the same direct (non-group) conversation. To create a group conversation, use createGroup.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority
Details · query
Kindquery
Authorityconvo.bsky.chat
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

members

requiredarray
  • minLength: 1
  • maxLength: 10
itemsstring · did

Output

application/json

convo

requiredref
Reference

Errors

AccountSuspended

No description in schema.

BlockedActor

No description in schema.

BlockedSubject

No description in schema.

MessagesDisabled

No description in schema.

NotFollowedBySender

No description in schema.

RecipientNotFound

No description in schema.

Similar lexicons

semantic match

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

  • chat.bsky.convo.getConvoAvailability

    query

    Check whether the requester and the other members can start a 1-1 chat. Only applicable to direct (non-group) conversations. If an existing convo is found for these members, it is returned. Does not create a new convo if it doesn't exist.

  • chat.sprk.convo.getConvoForMembers

    query

  • chat.sprk.convo.getConvoAvailability

    query

    Get whether the requester and the other members can chat. If an existing convo is found for these members, it is returned.

  • chat.bsky.moderation.getConvo

    query

    Gets an existing conversation by its ID, for moderation purposes. Does not require the requester to be a member of the conversation.

  • chat.bsky.moderation.getConvos

    query

    Gets existing conversations by their IDs, for moderation purposes. Does not require the requester to be a member of the conversations. Unknown IDs are silently omitted from the response.