social.colibri.beta.role.delete

Deletes a role.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authorityrole.beta.colibri.social
Indexed

Procedure

procedure · POST

Input

application/json

community

requiredstring · did

The community the role belongs to.

role

requiredstring · record-key

The role's record key.

Output

application/json

Errors

AuthRequired

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

Forbidden

The caller lacks the role.manage permission.

CommunityNotFound

No community exists at the given DID.

RoleNotFound

No role exists at the given record key.

RoleProtected

The role is marked protected and cannot be deleted.

RoleDefault

Every member holds the role from the moment they join, so it cannot be deleted.

RoleHierarchy

The role is at or above the caller's highest role position.

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.role.delete

    procedure not from the namespace authority

    Deletes a role.

  • Deletes a role the Community defined, or, for the key moderator, puts the built-in moderator role back to its default permissions. A role someone holds cannot be deleted; move them to another role first. Only an administrator may delete roles. Recorded in the moderation log.

  • Remove a role. Requires group.configure. Fails if any membership still holds it.

  • Deletes the community's spaces and its account. Members' own records stay in their own repos and simply become unreadable.

  • Deletes a category. Its channels are not deleted: they become uncategorised until moved to another category.