Lexicon Garden

social.coves.community.create

Create a new community. Requires authentication.

Repository @coves.social did:web:coves.social namespace authority
Details · procedure
Kindprocedure
Authoritycommunity.coves.social
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

allowExternalDiscovery

boolean

Whether other Coves instances can index and discover this community

  • default: true

avatarBlob

string

Base64-encoded avatar image data (png, jpeg, or webp)

  • maxLength: 1400000

avatarMimeType

string

MIME type of the avatar image (image/png, image/jpeg, image/webp)

  • maxLength: 128

bannerBlob

string

Base64-encoded banner image data (png, jpeg, or webp)

  • maxLength: 2800000

bannerMimeType

string

MIME type of the banner image (image/png, image/jpeg, image/webp)

  • maxLength: 128

categories

array

Community categories for discovery

  • maxLength: 3
itemsstring
  • maxLength: 50

description

requiredstring

Community description

  • maxLength: 10000
  • maxGraphemes: 1000

displayName

string

Display name for the community

  • maxLength: 1280
  • maxGraphemes: 128

language

string · language

Primary language of the community

membershipThreshold

integer

Reputation threshold required for membership

  • minimum: 0
  • maximum: 10000
  • default: 100

name

requiredstring

Short community name used as the local part of the handle (e.g., 'gaming'). Must be a valid DNS label: ASCII letters, digits, and hyphens only.

  • maxLength: 63

rules

array

Community rules

  • maxLength: 10
itemsstring
  • maxLength: 2000
  • maxGraphemes: 200

visibility

string

Community visibility level

  • maxLength: 64
  • default: "public"
  • knownValues: public | unlisted | private

Output

application/json

cid

requiredstring · cid

CID of the created community profile

did

requiredstring · did

DID of the created community

handle

requiredstring

Scoped handle of the created community (~name@instance)

  • maxLength: 512

uri

requiredstring · at-uri

AT-URI of the created community profile

Errors

NameTaken

Community name is already taken

TooManyCommunities

User has reached the maximum number of communities they can create

Similar lexicons

semantic match

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

  • social.coves.community.update

    procedure

    Update community profile. Requires authentication and moderator/admin permissions.

  • social.colibri.beta.community.create

    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.

  • 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.coves.community.profile

    record

    A community's profile information (V2: stored in community's own repository)

  • social.colibri.beta.category.create

    procedure

    Creates a category in a community.