social.colibri.beta.community.listMembers

colibri.social

Documentation

Lists a community's admitted members.

main query

Lists a community's admitted members.

Parameters

community string did Required

The community to list members of.

cursor string Optional

The cursor from a previous call, for fetching the next page.

limit integer Optional

The maximum number of results to return.

role string record-key Optional

Filters to members holding this role.

Output

Encodingapplication/json
cursor string Optional

A cursor for fetching the next page.

members array Required

The community's members.

Errors

AuthRequired The request is missing, malformed, or unverifiable service auth.
Forbidden The requesting user lacks permission to list this community's members.
CommunityNotFound No community exists with that DID.
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
The community to list members of.
The cursor from a previous call, for fetching the next page.
The maximum number of results to return.
Filters to members holding this role.
View raw schema
{
  "description": "Lists a community's admitted members.",
  "errors": [
    {
      "description": "The request is missing, malformed, or unverifiable service auth.",
      "name": "AuthRequired"
    },
    {
      "description": "The requesting user lacks permission to list this community's members.",
      "name": "Forbidden"
    },
    {
      "description": "No community exists with that DID.",
      "name": "CommunityNotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "A cursor for fetching the next page.",
          "type": "string"
        },
        "members": {
          "description": "The community's members.",
          "items": {
            "ref": "social.colibri.beta.community.defs#memberView",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "members"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "community": {
        "description": "The community to list members of.",
        "format": "did",
        "type": "string"
      },
      "cursor": {
        "description": "The cursor from a previous call, for fetching the next page.",
        "type": "string"
      },
      "limit": {
        "default": 50,
        "description": "The maximum number of results to return.",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "role": {
        "description": "Filters to members holding this role.",
        "format": "record-key",
        "type": "string"
      }
    },
    "required": [
      "community"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@