social.coves.community.subscribe Documentation (EN)

main procedure

Subscribe to a community to see its posts in your feed. Requires authentication.

Input

Encodingapplication/json

community stringat-identifier Required

DID or handle of the community to subscribe to

Output

Encodingapplication/json

cid stringcid Required

CID of the created subscription record

existing boolean Optional

True if item was already subscribed

uri stringat-uri Required

AT-URI of the created subscription record

Errors

CommunityNotFound Community not found

Blocked Cannot subscribe - you are blocked from this community

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://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "community"
      ],
      "properties": {
        "community": {
          "type": "string",
          "format": "at-identifier",
          "description": "DID or handle of the community to subscribe to"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "CommunityNotFound",
      "description": "Community not found"
    },
    {
      "name": "Blocked",
      "description": "Cannot subscribe - you are blocked from this community"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "uri",
        "cid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid",
          "description": "CID of the created subscription record"
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the created subscription record"
        },
        "existing": {
          "type": "boolean",
          "description": "True if item was already subscribed"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Subscribe to a community to see its posts in your feed. Requires authentication."
}