Manage users and groups

Every person is a user; their account persona and group membership determine what they may do.

Administrators invite an account participant with POST /api/users/invitations, supplying email, display name, and either the administrator or attendee persona. The invited user can then request an account-scoped magic link. Owners and teachers receive the administrator persona and use the admin system.

Use groups for audience eligibility, not administrative authorization. Examples include “Monthly members”, “Beginners”, and “Teacher training 2026”. Administrators may create, rename, delete, and assign participating users through the API.

The /admin/users workspace is the entry point for people administration. It links to focused People, Groups, and Invite person workspaces at /admin/users/people, /admin/users/groups, and /admin/users/invite. Each page keeps its task-specific actions together and provides a consistent return path to Users & groups. Selecting a person in the People list opens their focused profile at /admin/users/{userId}, where their profile details and role can be reviewed and edited. Changing a role displays a warning because administrator access includes the full studio workspace; the attendee role is labelled Student in the admin UI.

Before deleting a group, review instances restricted to it. A deleted group identifier no longer grants access, which can make those instances unavailable until their bookability is updated.