Users
The Users page (/admin/users) lets you view and manage the users registered in BasePeak.AI. It is available to users with the Administrator or User Manager role, and to users with a custom role that contains the user:manage permission.
The Users and Groups pages only appear when an authentication provider is configured. For more information, see Auth Providers.
User List
The overview displays all registered users in a table with the following columns:
| Column | Description |
|---|---|
| The user's email address | |
| Roles | All of the user's roles, assigned directly or received through groups (filterable) |
| Threads | The number of the user's threads |
| Created | Date of registration |
| Last Active | Date of the last activity |
You can sort by any column by clicking its header. By default, the most recently registered users are at the top. Use the search field to filter the list by email address, username, display name, or role. Use the filter on the Roles column to show only users with specific roles.
In the top right, an indicator shows the number of registered users (if a limit is set, in the format "current / maximum"). Support accounts are not counted.
To open the detail view, click a row. Using the action menu (⋮) at the end of a row, you can delete a user; this requires a confirmation.
Export Access Review
Export access review (CSV) downloads a CSV file with all users. It contains one row per user with user ID, email address, username, directly assigned roles, groups, and effective permissions. Roles and groups appear with their internal names (for example user-manager), several entries separated by ;. Use it for regular review and recertification of access rights.
Roles
A role is a named set of permissions. It determines what a user is allowed to do on the platform. A user can have several roles; they then hold all permissions of these roles combined.
Built-in Roles
BasePeak.AI comes with the following roles. They cannot be changed or deleted.
| Role | Description |
|---|---|
| Administrator | Full system access including all admin features. |
| Creator | Can create agents and edit the ones they own or were granted, manage providers, and build their own agent teams. |
| Creator+ | Everything a Creator can do, and edit every agent that is not admin-restricted. |
| Basic | Standard user; use agents and own resources. |
| Auditor | Read-only monitoring: all threads plus access review of users, roles, and permissions. |
| User Manager | Manage users, groups and roles without system administration. |
Creators edit only the agents they own or were granted. Assign Creator+ to someone who must edit every agent that is not admin-restricted.
Custom Roles
Under Roles (/admin/roles) you see all roles with Name, Display Name, Type (Built-in or Custom), number of Members, and number of Permissions (roles with instance:admin show All). Use Create Role to add a custom role. Name is required; Display Name and Description are optional. Under Permissions, you choose what the role allows. On a custom role you can later change Display Name, Description and Permissions; the Name stays. You can edit or delete a role only if you hold all of its permissions yourself. A role that gives the last administrator their rights cannot be deleted.
A role's detail view lists under Members every user who holds the role, and how: Direct or through a group (for example via Department 10). Below that are the Groups with this role and the role's permissions.
You can only grant permissions you hold yourself. This also applies when assigning and removing roles.
How a User Gets a Role
- Directly: on the user's detail page via Assign Role (see below).
- Through a group: If a group has a role, all members of the group receive that role. You assign a group's roles in the group's detail view under Assigned Roles (see Groups).
- New users receive no role when they register. They have the same rights as with the Basic role: they use agents and their own resources. Exceptions: system-level admins (see Notes) get the Administrator role at their first sign-in, and users who join a group with roles through an assignment rule get that group's roles.
User Details
A user's detail page is divided into the following cards:
- User Info — shows Email, Created, and Last Active. If the user still has the former individual Auditor permission, it is shown here as an additional indicator. To grant these rights today, use the Auditor role.
- Assigned Roles — lists the roles assigned to the user directly. Roles the user receives through a group are not listed here; they appear in the Roles column of the user list and in the role's detail view.
- Effective Permissions — shows all permissions the user holds from their directly assigned roles and the roles of their groups combined, for example
agent:create. - Groups — lists the groups the user belongs to. Each group is linked to its detail page (see Groups). Under Advanced Details, you can additionally view the user's OAuth Claim Groups.
- Token Usage — shows the Prompt Tokens, Completion Tokens, and Total Tokens consumed by this user.
The Groups and Token Usage cards and the Manage Groups and Delete buttons are only visible to administrators: users with the Administrator role (directly or through a group) or another role with the instance:admin permission.
Assign and Remove Roles
To assign a role to a user:
- On the detail page, click Assign Role in the Assigned Roles card
- In the dialog, select the desired role; if the role has a description, it is shown
The role is assigned immediately. Roles with permissions you don't hold yourself are disabled in the dialog.
To remove a role, click the trash icon next to it. A role the user receives through a group is removed in the group, or by taking the user out of the group.
Manage Groups
To adjust a user's group membership:
- On the detail page, click Manage Groups
- Enable or disable the group checkboxes to add or remove the user
- Close the dialog; the membership is updated immediately
Managing the groups themselves is described under Groups.
Notes
- Users who are explicitly set as an admin at the system level are marked with a shield icon on their detail page. They cannot be deleted in the UI, and they receive the Administrator role again every time they sign in, even if it was removed.
- Only an administrator can delete an administrator. The User Manager role alone cannot.
- Support accounts are marked with a badge, Support by default.
- BasePeak.AI always keeps at least one administrator. You cannot delete the last administrator or remove the Administrator role from them.
- Deleting a user cannot be undone.