Lexicon Garden

social.colibri.beta.community.update

Updates a community's settings. A field left absent stays unchanged.

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

community

requiredstring · did

The community to update.

customEmoji

string

Which custom emoji render in this community. all allows custom emoji from any source, local only the community's own emoji, none disables custom emoji. Disallowed emoji show their fallback text.

  • knownValues: all | local | none

description

string

The community's description.

  • maxLength: 256

hideOwnerBadge

boolean

Whether the owner badge next to the community owner's name is hidden.

labelers

array

DIDs whose labels this community honours.

itemsstring · did

A labeler.

linkEmbeds

boolean

Whether link previews are shown by default.

name

string

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.

requiresApprovalToJoin

boolean

Whether joining produces an application to approve.

Output

application/json

community

requiredref

The updated community.

Reference

Errors

AuthRequired

The request is missing, malformed, or unverifiable service auth.

Forbidden

The requesting user lacks the community.manage permission.

CommunityNotFound

No community exists with that DID.

CredentialsUnavailable

The AppView's stored credentials for this community are missing or unusable.

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.