social.colibri.beta.category.update

Updates a category's name and the permissions its channels inherit.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority

Details · procedure

Kind	procedure
Authority	category.beta.colibri.social
Indexed	26d ago · 2026-10-15

Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

allowedMembers

array

Members allowed to post in the category's channels in addition to allowedRoles. Absent leaves the current value unchanged.

itemsstring · did

A member permitted to post.

allowedRoles

array

Roles allowed to post in the category's channels. Absent leaves the current value unchanged.

itemsstring · record-key

A role permitted to post.

community

requiredstring · did

The community the category belongs to.

name

string

The category's new name.

minLength: 1
maxLength: 32

ownerOnly

boolean

Whether only community admins may post in the category's channels. Absent leaves the current value unchanged.

visibleToMembers

array

Members that may read the category's channels in addition to visibleToRoles. Absent leaves the current value unchanged.

itemsstring · did

A member permitted to read.

visibleToRoles

array

Roles that may read the category's channels. Absent leaves the current value unchanged.

itemsstring · record-key

A role permitted to read.

Output

application/json

Errors

AuthRequired

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

Forbidden

The caller lacks the category.update permission, or grants visibility to a role at or above their own highest position.

CommunityNotFound

No community exists at the given DID.

CategoryNotFound

No category exists at the given record key.

CredentialsUnavailable

The AppView cannot act as the community because its stored credentials are missing or unusable.

Similar lexicons

semantic match

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

social.colibri.beta.channel.update
procedure

Updates a channel's configuration. An absent field leaves the current value unchanged.
social.colibri.channel.update
procedure

Updates a channel's settings.
social.colibri.beta.category.create
procedure

Creates a category in a community.
social.colibri.category.update
procedure not from the namespace authority

Renames a category.
social.colibri.beta.category
record

A named group of channels within a community.