Skip to main content

Users

Introduction

The Users tab in Settings > Users and Groups is where administrators manage individual platform users. From this area, you can search existing users, review their profile information, assign roles, and control the subtenants each user can access.

This page focuses on two areas:

  • Managing users from the Users tab.
  • Understanding the roles that can be assigned to a user.

What You Can Manage

From the Users tab, administrators can typically:

  • Search and filter users by fields such as name, email, phone number, job title, or confirmation status.
  • Create new users.
  • Edit existing users.
  • Assign platform roles.
  • Assign subtenant access.
  • Review whether the user's email is confirmed.
  • Recover passwords
  • Delete users

Accessing Users

  1. Go to Settings > Users and Groups.
  2. Open the Users tab.
  3. Use the search inputs at the top of the grid to locate a user, or click New User to create one.

The grid provides a quick operational view of the users currently registered in the tenant.

Users list view


Editing a User

When you open a user record, the edit form lets you review and update the information associated with that account.

Typical fields include:

  • Name
  • Last name
  • Job title
  • Email
  • Phone number
  • Profiles
  • Roles
  • Subtenants
  • Language

The Roles section determines which platform capabilities the user can administer or use. The Subtenants section controls the organizational scopes available to that user.

tip

Use roles to define what a user can do, and use subtenants to define where they can do it.

User edit form


Roles

Users can have one or multiple roles within the platform. Each role grants access to specific features and functionalities.

Agent

RoleDescription
Agent AdministratorGrants full administrative access to agents, including configuration and management.
Agent ExecutionAllows the user to execute agents without granting full administrative permissions.
Agent Instance UserGrants the user execution and audit access to agents.
Agent UserMakes the user eligible for agent-specific permission assignments. By itself, this role does not grant access to any agent.
Agent Usage AdministratorAllows the user to review agent usage and monitoring information.
Agent Quality Studio AdministratorGrants full administrative access to Agent Quality Studio, including test plan creation and test executions.
Sensible Data Obfuscation UserAllows the user to view obfuscated sensitive data in agent executions.

Usage, cost, and limits

RoleDescription
Cost AdministratorAllows the user to review cost information and manage billing-related configuration.
Usage Limits AdministratorAllows the user to define and manage organization-wide usage limits.
Scoped Limits AdministratorAllows the user to manage scoped usage limits.

AI Chat

RoleDescription
Serenity* AI Chat UserAllows the user to access and use Serenity* AI Chat.
Serenity* AI Chat auditorAllows the user to review Serenity* AI Chat activity, costs, and audit-related information.
Serenity* AI Chat Configuration AdministrationGrants full administrative access to Serenity* AI Chat configuration settings.

Supporting Agent and Automation Services

RoleDescription
AI ServiceExecutionAllows the user to run standalone AI services available in the platform.
Workflow AdministrationGrants full administrative access to workflows and their configuration.
Workflow ExecutionAllows the user to run workflows, including execution through the API.
Scheduled Trigger AdministratorGrants full administrative access to scheduled triggers.
Dataset AdministratorGrants full access to datasets, tables, and related dataset definitions.
Fine Tuning UserAllows the user to create and manage fine-tuned models.

Tenant and Organization administration

RoleDescription
Tenant AdministratorGrants full tenant-level administrative access across platform areas.
Subtenant AdministratorGrants full administrative access to subtenants and their configuration.
User AdministratorAllows the user to create, update, and manage users and their assignments.
Security Policies AdministrationAllows the user to manage security and sign-in policies in the Compliance Center.
Api Key AdministratorAllows the user to manage system-specific API keys.
AI Connection Setting AdministrationAllows the user to manage provider-related API keys in the Compliance Center.

Security Profiles

Instead of assigning the same set of roles one by one for each user, you can group roles into a security profile and then reuse that profile across multiple users.

This helps standardize access, reduces manual configuration, and makes role management easier when several users need the same permissions.

Use the Profiles field in the user form to assign one or more existing security profiles to the user, depending on how your tenant is configured.

Best Practices

  • Assign the minimum set of roles required for the user's responsibilities.
  • Review role assignments regularly, especially for administrative roles.
  • Prefer role-based access over sharing accounts between people.
  • Review subtenant assignments together with roles to avoid broader access than intended.