Use user management to control who can access, edit, and deploy your agent. Without proper permissions, anyone on the team can push changes to production or access sensitive conversation data. Access user management from the Users tab on the workspace homepage (next to Agents, Secrets, and API Keys).Documentation Index
Fetch the complete documentation index at: https://docs.poly.ai/llms.txt
Use this file to discover all available pages before exploring further.
Inviting users
Add colleagues to your account to collaborate on building and managing agents. Each user can be assigned permissions that determine their level of access to different areas of Agent Studio. See Invite users for step-by-step instructions.Granular permissions
Agent Studio supports mixed permissions across different navigation areas. Give users edit access where they build, and restrict access where they only need visibility.Permission levels
Each navigation area can be set to one of three access levels:| Level | Description |
|---|---|
| None | User cannot see or access this area |
| Read | User can view content but cannot make changes |
| Edit | User can view and modify content |
Navigation areas
Set permissions for each major section of Agent Studio:| Area | What it controls |
|---|---|
| Analytics | Smart analyst, Conversations, Agent analysis |
| Build | Agent, Knowledge, Flows, Tools, Variant management, Call handoffs, SMS, Real-time configuration, Configuration builder, Test suite |
| Channels | Voice configuration, Chat (Chat configuration and Widget share a single permission) |
| Configure | General, Numbers, APIs, Integrations, Metrics, Dashboards, CSAT |
| Deployments | Environments, Project history |
Expandable sections
For more specific control, expand any section to set permissions on individual items. For example:- Expand Analytics to set separate permissions for Conversations vs Smart analyst
- Expand Build to allow Edit on Knowledge but Read-only on Tools
Example permission configurations
See role permissions for ready-made configurations for common roles like content editors, QA analysts, and voice specialists.Account-level roles
In addition to granular permissions, users have an account-level role:| Role | Description |
|---|---|
| Admin | Full access to all features, including user management and billing |
| Member | Access determined by assigned permissions |
Security
- User permissions are scoped to your account
- Sensitive data is only accessible to authorized users based on their assigned permissions
- Permission changes take effect immediately
- Audit logs track permission modifications (for Enterprise accounts)
Related pages
Role permissions
Detailed permission reference and common configurations.
Invite users
Add team members with role-based access control.