Lexicon Garden

social.colibri.beta.community.create

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.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritycommunity.beta.colibri.social
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

description

string

The community's description.

  • maxLength: 256

handlePrefix

string

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

name

requiredstring

The community's name.

  • minLength: 1
  • maxLength: 32

overrideUserNameColors

boolean

Whether only role colours are shown in chat. Members' own name colours are hidden, and a member without a coloured role shows the default name colour. Defaults to false.

requiresApprovalToJoin

boolean

Whether joining produces an application a moderator must approve. Defaults to false.

Output

application/json

community

requiredref

The newly created community.

Reference

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 the com.atproto.space policy methods, so it cannot host community spaces.

UpstreamFailure

A PDS or third-party call the AppView depends on failed.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • social.colibri.community.create

    procedure not from the namespace authority

    Creates a community, bootstrapping its DID repo with a default category, channel, owner role, and member record.

  • social.colibri.beta.channel.create

    procedure

    Creates a channel. This creates a space for the channel, then writes the channel's configuration record at key 'self' inside that space.

  • social.colibri.beta.community.adopt

    procedure

    Adopts an existing account as a community: this AppView takes custody of its credentials, creates the four community spaces on whichever PDS already hosts it, and seeds the same starter layout social.colibri.beta.community.create does. The account keeps its own DID, handle and PDS, and the caller becomes its owner. Use this instead of community.create to bring your own DID.

  • social.colibri.channel.create

    procedure

    Creates a channel in a category of a community.

  • social.colibri.beta.category.create

    procedure

    Creates a category in a community.