social.coves.aggregator.listForCommunity Documentation (EN)

main query

List all aggregators authorized for a specific community. Used by community settings UI to show enabled/disabled aggregators. Authentication optional.

Parameters

community string Required

Community identifier (DID, handle, name@origin, or bare local name) of the community

cursor string Optional

Pagination cursor

enabledOnly boolean Optional

Only return enabled aggregators

limit integer Optional

Maximum number of aggregators to return

Output

Encodingapplication/json

aggregators array Required

Array of aggregator authorizations for this community

cursor string Optional

Pagination cursor for next page

Errors

CommunityNotFound Community not found

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

community * Community identifier (DID, handle, name@origin, or bare local name) of the community

cursor Pagination cursor

enabledOnly Only return enabled aggregators

limit Maximum number of aggregators to return

View raw schema

{
  "description": "List all aggregators authorized for a specific community. Used by community settings UI to show enabled/disabled aggregators. Authentication optional.",
  "errors": [
    {
      "description": "Community not found",
      "name": "CommunityNotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "aggregators": {
          "description": "Array of aggregator authorizations for this community",
          "items": {
            "ref": "social.coves.aggregator.defs#authorizationView",
            "type": "ref"
          },
          "type": "array"
        },
        "cursor": {
          "description": "Pagination cursor for next page",
          "maxLength": 500,
          "type": "string"
        }
      },
      "required": [
        "aggregators"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "community": {
        "description": "Community identifier (DID, handle, name@origin, or bare local name) of the community",
        "maxLength": 320,
        "type": "string"
      },
      "cursor": {
        "description": "Pagination cursor",
        "maxLength": 500,
        "type": "string"
      },
      "enabledOnly": {
        "default": false,
        "description": "Only return enabled aggregators",
        "type": "boolean"
      },
      "limit": {
        "default": 50,
        "description": "Maximum number of aggregators to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      }
    },
    "required": [
      "community"
    ],
    "type": "params"
  },
  "type": "query"
}