Skip to main content

Bulk Operations

Last updated: 2026-05-20

The Groups list, Members tab, and Settings tab all support multi-select. Combined with the Clone Group action, this lets admins make sweeping changes without scripting against the API.


Bulk-deleting groups​

Permissions — group:delete

  1. Open /groups/all (All Groups).
  2. Use the checkbox at the top of each row to select groups, or the master checkbox to select every visible group.
  3. The selection counter appears in the toolbar — N selected.
  4. Click Delete Selected (N).
  5. Confirm the dialog.

Each group is deleted independently. The toolbar reports successes and surfaces failures as toasts. Deletion is permanent — to restore, use Archive instead (see below).


Bulk-archiving groups​

Permissions — group:update

Archiving sets status: ARCHIVED instead of removing the group. Members lose access but the data is recoverable.

  1. From /groups/all, select multiple groups.
  2. Click Archive Selected.
  3. Confirm.

To bring archived groups back, open them individually and click Restore on the Settings tab.

Today the bulk-archive action is exposed via the bulkArchiveGroups mutation; UI access may depend on host shell. If you don't see it, archive groups one-by-one via the Settings tab.


Bulk-removing members​

Permissions — group-member:delete

  1. Open /groups/:groupId/members.
  2. Tick the row checkboxes for the members you want to remove.
  3. Click Remove Selected in the toolbar.
  4. Confirm the count.

Same last-owner protection applies: you cannot remove the only OWNER in the selection.


Bulk-deleting settings​

Permissions — group-setting:delete

In the Settings tab key-value section, select multiple settings using the row checkboxes and click Delete Selected (N).


Cloning a group​

Permissions — group:create (the clone is a new resource)

The Clone Group action duplicates a group's configuration into a brand-new group. You can choose whether to copy members too.

  1. Open the source group.
  2. From the Settings tab (admin) or the group-detail action menu, click Clone Group.
  3. Enter a unique name for the clone.
  4. Toggle Include Members if you want the clone to inherit the source's membership.
  5. Click Clone.

The clone is created in the same workspace, gets a fresh id and slug, and starts with the source's:

  • Group type, visibility, scope, status
  • Membership type, composition mode, allowed entity types
  • Nesting and invite policies
  • Metadata
  • Settings (key-value store)
  • Members (when Include Members is on)

It does not copy:

  • Hierarchy links
  • Membership rules (you'll re-create them on the clone if you want dynamic behavior)
  • Audit history

A GROUP_CREATED event is recorded on the clone with a reference to the source group ID.


See also​