Skip to main content

Managing Group Members

Last updated: 2026-05-20

Members of a group are not limited to people — depending on the group's compositionMode and allowedEntityTypes, a member can be a User, App, File, VibeDeck, Resource, or another Group.

Permissions — adding, removing, and re-roling members all require group-member:create / group-member:delete / group-member:update on the target group. The Members tab quietly hides actions you don't have permission to perform.


Where to manage members​

ViewRouteUse for
Per-group Members tab/groups/:groupId/membersAdd, remove, re-role, search members of one group
Member Directory/groups/membersWorkspace-wide rollup: every group with its member count and average

The Member Directory is a read-only overview. All edit actions happen inside a single group's Members tab.


Adding Members​

  1. Open the group's Members tab (/groups/:groupId/members).
  2. Click Add Members — the Add Members modal opens.
  3. For each member, pick:
  • Type — User, App, File, VibeDeck, Resource, or Group
  • Email (for User) or Entity ID (for everything else)
  • Role — MEMBER, MODERATOR, ADMIN, OBSERVER, or GUEST (OWNER cannot be assigned here — use Transfer Ownership instead)
  1. Click Add to List to stage each member. The staged list shows their type, identifier, and role.
  2. Repeat for as many members as you want to add in one batch.
  3. Click Add N Members at the bottom to submit.

Behind the scenes the backend:

  • Resolves emails to user IDs via the global auth service.
  • Returns a per-entry success / failure breakdown — failed entries surface as a toast listing the problem (e.g. user not found, duplicate, composition-mode violation).
  • Records each successful add in the activity feed (MEMBER_ADDED).

Tip — use Enter in the input field to stage the current row without taking your hand off the keyboard.


Roles and Permissions​

Roles are evaluated against the current viewer's membership when deciding what actions the UI exposes. See 01-getting-started for the full list.

RoleInviteAdd / remove membersChange rolesEdit group settingsManage hierarchyDelete groupTransfer ownership
OWNERxxxxxxx
ADMINxxxxx——
MODERATORxxx————
MEMBERx (if allowMemberInvites)——————
OBSERVER———————
GUEST———————
BOT———————

Workspace-level RBAC permissions can override these — a workspace admin without group membership can still manage groups via the group:* actions.


Updating a Member's Role​

  1. In the Members tab, find the member.
  2. Click the role dropdown / badge next to them.
  3. Select the new role.
  4. Changes take effect immediately. An event (MEMBER_ROLE_UPDATED) is recorded.

Last-owner protection​

You cannot demote the only OWNER of a group. The mutation fails with a guard error — first transfer ownership to a different member or promote a second OWNER, then change the role.


Removing Members​

Single removal​

  1. Open the member's row context menu.
  2. Click Remove and confirm.

Bulk removal​

  1. Select multiple members using the row checkboxes.
  2. Click Remove Selected.
  3. Confirm the count in the dialog.

Removed members lose access immediately. Removal is recorded as MEMBER_REMOVED in the activity feed.

Last-owner protection also applies here — the last OWNER cannot be removed.


Filtering and searching members​

The Members tab exposes three filter controls:

  • Search — name, email, or entity ID
  • Entity type — User / App / File / VibeDeck / Resource / Group / All
  • Role — OWNER / ADMIN / MODERATOR / MEMBER / OBSERVER / GUEST / All

Filters combine with AND semantics.


Transferring Ownership​

Only the current OWNER can transfer ownership. There is no general UI button in the Members tab today — ownership transfer is performed via the Settings tab (admin shell) or through an API call to transferGroupOwnership. The successor must already be a member of the group; on transfer:

  • The successor becomes OWNER.
  • The previous owner is downgraded to ADMIN.
  • An OWNERSHIP_TRANSFERRED event is recorded.

Member Activity​

All membership changes — adds, removes, role changes, ownership transfers — are recorded in the group's Activity tab (/groups/:groupId/activity) under the Members filter. See activity feed.


See also​