Permissions by Role
This page lists what each of the six built-in HYPR AgentPass™ roles can do, by product area. Use it to choose a role for someone, or to check who can perform a task.
A permission's scope is All (every record), Own (only the signed-in person's own records, or the agents they own or supervise) or No access. To see each individual grant, or to build a custom role, see Roles and Permissions.
The Built-In Roles
The console shows a built-in role by its display name, for example in the account menu. The stored name appears on the Roles tab of People, in the Role column on the Users tab, and in identity provider mappings. The Capabilities column of the Roles tab shows each role's grant count out of the 51 permissions available.
| Display name | Stored name | Grants | What the role is for |
|---|---|---|---|
| Admin | AgentPassAdmin | 51 of 51 | Runs the gateway. Holds every permission. The role is locked, so it cannot be edited or reset |
| Operator | AgentPassOperator | 31 | Runs day-to-day operations. Reads broadly, changes agent status, decides approvals and manages its own policies and cloud agents |
| Supervisor | AgentPassSupervisor | 19 | Oversees their own agents. Decides their approvals, manages their own policies, and resumes their agents' paused sessions |
| Security analyst | AgentPassSecurityAnalyst | 16 | Triages guardrail alerts, and contains agents and sessions. Reads broadly, and changes no policies, connectors or gateway settings |
| Auditor | AgentPassAuditor | 17 | Reads every configuration and record, and exports guardrail evidence. Changes nothing |
| Model governance owner | AgentPassModelGovernanceOwner | 6 | Registers and governs the judge models guardrails use. Reads guardrail posture and the Request log |
A custom role, or a built-in role an administrator renamed, shows under its stored name everywhere.
Operations Roles
| Area | Admin | Operator | Supervisor |
|---|---|---|---|
| People and roles | Manage all; role is locked | View all | View own record |
| Connectors | Manage all | View all | No access |
| Agents | Manage all | Edit all; change status and mobile access; synchronize providers | View and change status for own |
| Workload agents | Manage all | No access | No access |
| Cloud agents | Manage all | View all; manage own | Manage own |
| Approvals | View, decide, revoke and delete all | View, decide and revoke all | View, decide and revoke own |
| Conversations | View and send own | View and send own | View and send own |
| Policies | Manage and test all | View and test all; manage own | View all; manage and test own |
| Request log | View all | View all | View own |
| Gateway settings and API docs | Manage all | View all | No access |
| Notifications | Manage all | View all | No access |
| Passkeys | Manage all; enroll own | View and enroll own | View and enroll own |
| Data management | Manage all | View all | No access |
| Data classification | Manage all | View all | No access |
| Session watch | Manage all | View all | No access |
| AI SaaS user detail | View all | No access | No access |
| Policy MCP clients | Manage all | No access | No access |
| Access reviews | Run the program: schedules, opening, closing and export. Decide agents assigned to them | Decide agents assigned to them | No access |
| Guardrails | View, manage and validate all; resume or end a paused session of an agent they supervise | View all | Resume or end a paused session of an agent they supervise |
| Model governance | Manage all | No access | No access |
Workload agents covers creating workload agents and managing their credentials. See Workload Agents.
The Supervisor's Guardrails grant is Guardrails: Attest own. When a paused session is escalated to the agent's supervisor, it lets that supervisor approve resuming or ending the session. It opens no Guardrails pages.
Security, Audit and Model-Risk Roles
These three roles hold mostly read access.
| Area | Security analyst | Auditor | Model governance owner |
|---|---|---|---|
| People and roles | View all people | View all | No access |
| Connectors | View all | View all | No access |
| Agents | View all; change status | View all | No access |
| Workload agents | No access | No access | No access |
| Cloud agents | View all | View all | No access |
| Approvals | View all | View all | No access |
| Conversations | No access | No access | No access |
| Policies | View all | View all | No access |
| Request log | View all | View all | View all |
| Gateway settings and API docs | No access | View all | No access |
| Notifications | View all | View all | No access |
| Passkeys | View and enroll own | View own | View and enroll own |
| Data management | No access | View all | No access |
| Data classification | View all | View all | No access |
| Session watch | View all | View all | No access |
| AI SaaS user detail | No access | No access | No access |
| Policy MCP clients | No access | No access | No access |
| Access reviews | No access | No access | No access |
| Guardrails | View and manage all | View all | View all |
| Model governance | View all | View all | Manage all |
The Auditor holds no access-review permission. To collect access-review results, ask the person who runs the review program, who holds Access reviews: Manage, for an export. See Export the Results.
Rules That Span Roles
- Turning an agent off and on follows one rule in the console and the mobile app. A role that holds Agents: Toggle at Own scope, such as Supervisor, turns off only the agents the person owns, and turns one back on only if that person turned it off. See Who Can Turn an Agent Off and On.
- The Notifications page opens only for a role that holds Notifications: Manage. A role with Notifications: View alone, such as Operator, Security analyst or Auditor, does not see the page.
- Managing roles also covers mapping identity provider values to roles. See Map Identity Provider Values to a Role.
What each role sees in the console's sidebar is described in Console Navigation.
Related
- Roles and Permissions: create custom roles and assign them
- Running Agent Access Reviews: the two access-review permissions
- Controlling MCP Tool Access by Role: the tool grid each role also carries
- Data Classification: why
data-labels:manageis held apart fromconnectors:edit