social.colibri.beta.community.create

colibri.social

Documentation

Provisions a new community: an account on the AppView's PDS, its four spaces, an owner role, and a starter layout of two categories holding one text channel and one voice channel between them. This call runs long enough that progress is also emitted over social.colibri.beta.sync.subscribeEvents.

main procedure

Provisions a new community: an account on the AppView's PDS, its four spaces, an owner role, and a starter layout of two categories holding one text channel and one voice channel between them. This call runs long enough that progress is also emitted over social.colibri.beta.sync.subscribeEvents.

Input

Encodingapplication/json
description string Optional

The community's description.

maxLength: 256 bytes
handlePrefix string Optional

A slug used for the community handle instead of a generated one.

name string Required

The community's name.

maxLength: 32 bytesminLength: 1 bytes

Output

Encodingapplication/json

Errors

AuthRequired The request is missing, malformed, or unverifiable service auth.
InvalidRequest The arguments are inconsistent or malformed beyond schema validation.
AlreadyExists A community already exists with the requested handle.
PdsUnavailable The AppView's PDS could not be reached to provision the account.
SpacesUnsupported The AppView's PDS does not implement com.atproto.simplespace, so it cannot host community spaces.
UpstreamFailure A PDS or third-party call the AppView depends on failed.
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://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 32,
          "minLength": 1,
          "description": "The community's name."
        },
        "description": {
          "type": "string",
          "maxLength": 256,
          "description": "The community's description."
        },
        "handlePrefix": {
          "type": "string",
          "description": "A slug used for the community handle instead of a generated one."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthRequired",
      "description": "The request is missing, malformed, or unverifiable service auth."
    },
    {
      "name": "InvalidRequest",
      "description": "The arguments are inconsistent or malformed beyond schema validation."
    },
    {
      "name": "AlreadyExists",
      "description": "A community already exists with the requested handle."
    },
    {
      "name": "PdsUnavailable",
      "description": "The AppView's PDS could not be reached to provision the account."
    },
    {
      "name": "SpacesUnsupported",
      "description": "The AppView's PDS does not implement com.atproto.simplespace, so it cannot host community spaces."
    },
    {
      "name": "UpstreamFailure",
      "description": "A PDS or third-party call the AppView depends on failed."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "community"
      ],
      "properties": {
        "community": {
          "ref": "social.colibri.beta.community.defs#communityView",
          "type": "ref",
          "description": "The newly created community."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Provisions a new community: an account on the AppView's PDS, its four spaces, an owner role, and a starter layout of two categories holding one text channel and one voice channel between them. This call runs long enough that progress is also emitted over social.colibri.beta.sync.subscribeEvents."
}

Lexicon Garden

@