Users

The Users page (/admin/users) lets workspace administrators view and manage the users registered in BasePeak.AI. Only admin users can access this page.

note

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
Email	The user's email address (sortable)
Threads	The number of the user's threads; No threads if there are none
Role	The user's role (filterable): Admin, Creator, or User
Created	Date of registration (sortable)
Last Active	Date of the last activity; No activity if none has occurred yet

You can filter the list by email address or username using the search field. In the top right, an indicator shows the number of registered users (if a limit is set, in the format "current / maximum").

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.

Roles

BasePeak.AI has three roles that determine what a user is allowed to do on the platform:

Role	Description
Admin	Full access to all settings and features.
Creator	Can create and manage agents, tasks, and tools.
User	Can use agents and participate in threads.

User Details

A user's detail page is divided into three cards:

• User Info — shows Email, Role, Created, and Last Active. If the Auditor permission is active, it is shown here as an additional indicator.
• 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.

Update Role

To change a user's role or permissions:

1. On the detail page, click Update Role
2. In the dialog, select the desired Role; a short description explains each role
3. If needed, enable the Auditor permission using the toggle
4. Click Update Role to save the changes

The Auditor permission allows a user to view all threads across the organization. It can be enabled independently of the selected role.

Manage Groups

To adjust a user's group membership:

1. On the detail page, click Manage Groups
2. Enable or disable the group checkboxes to add or remove the user
3. 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. Their role cannot be changed and they cannot be deleted — the Update Role and Delete User buttons are disabled for these users.
• Deleting a user cannot be undone.