app.zeens.getConvos

zeens.app

Documentation

Return a viewer's conversation list (newest activity first), paginated. No message preview is returned. 'state' selects the inbox or the requests bucket.

main query

Return a viewer's conversation list (newest activity first), paginated. No message preview is returned. 'state' selects the inbox or the requests bucket.

Parameters

cursor string Optional

No description available.

limit integer Optional

No description available.

state string Optional

No description available.

viewer string did Required

A decentralized identifier (DID).

Output

Encodingapplication/json
allow string Optional

No description available.

convos array Required

No description available.

cursor string Optional

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
A decentralized identifier (DID).
View raw schema
{
  "description": "Return a viewer's conversation list (newest activity first), paginated. No message preview is returned. 'state' selects the inbox or the requests bucket.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "allow": {
          "enum": [
            "off",
            "mutuals",
            "everyone"
          ],
          "type": "string"
        },
        "convos": {
          "items": {
            "properties": {
              "convoId": {
                "type": "string"
              },
              "latestAt": {
                "type": "string"
              },
              "peerDid": {
                "format": "did",
                "type": "string"
              },
              "unread": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "convoId",
              "peerDid",
              "latestAt",
              "unread"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "cursor": {
          "type": "string"
        }
      },
      "required": [
        "convos"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 36,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "state": {
        "default": "inbox",
        "enum": [
          "inbox",
          "requests"
        ],
        "type": "string"
      },
      "viewer": {
        "format": "did",
        "type": "string"
      }
    },
    "required": [
      "viewer"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@