Skip to main content

Permissions Reference

Last updated: 2026-05-20

Every action in the Groups module is guarded by an RBAC permission check at the API gateway. The UI also queries your effective permissions and hides buttons you cannot use, so most users never see a denial. This page lists the permissions in resource:action form so administrators can grant them via RBAC policies.

Authorization is also influenced by your membership role on the specific group (OWNER, ADMIN, MODERATOR, ...). The UI combines the workspace permission and your group role when deciding what to show.


Group permissions​

PermissionWhat it allows
group:readRead group metadata, members, hierarchy, audit logs
group:createCreate a new group (also creates an RBAC resource record)
group:updateUpdate group configuration, manage hierarchy, archive / restore
group:deletePermanently delete a group
group:exportRun the per-group export
group:manageTransfer ownership (OWNER-only by default)

group:read is implicit for the owner, for non-PRIVATE groups, and for any member of the group.


Member permissions​

PermissionWhat it allows
group-member:readList members of a group, check membership
group-member:createAdd members
group-member:updateChange a member's role
group-member:deleteRemove members

Invitation permissions​

PermissionWhat it allows
group-invitation:createSend invitations
group-invitation:updateAccept / decline pending invitations
group-invitation:deleteCancel pending invitations (admin-side)

Setting permissions​

PermissionWhat it allows
group-setting:createAdd a new key-value setting
group-setting:updateModify an existing setting
group-setting:deleteDelete a setting

Membership rule permissions​

PermissionWhat it allows
group-rule:readView rules and their execution history
group-rule:createDefine a new rule
group-rule:updateModify a rule
group-rule:deleteRemove a rule
group-rule:executeTrigger an on-demand rule sync

Template permissions​

PermissionWhat it allows
group-template:readList and view templates
group-template:createCreate a new template
group-template:updateEdit a template
group-template:deleteDelete a template

Audit log permissions​

PermissionWhat it allows
group-audit-log:readRead a group's audit log entries

Membership-role capability matrix​

In addition to RBAC, your role on the group controls UI affordances. See 03-managing-members for the full grid.

Quick summary:

  • OWNER — everything, including delete and transfer
  • ADMIN — everything except delete and ownership transfer
  • MODERATOR — member management only
  • MEMBER — invite (if enabled) and read
  • OBSERVER — read-only
  • GUEST — limited external access
  • BOT — programmatic actor; usually paired with App / Service entities

Public vs. self queries​

A handful of queries are membership-scoped via @rbac(scopeType: "self"):

  • myGroups — only returns groups the actor belongs to
  • Membership checks on the viewer's own actor ID

Everything else is workspace-scoped via @rbac(scopeType: "wspace") and requires the workspace context header.


See also​