ReferencePermissions

Permissions

Every permission is a resource:action pair, such as agent:create. A role is a set of these permissions. Docs pages link here by permission name. Access Control explains how roles and per-item grants work together.

Predefined Roles

Every organization has these four roles. You cannot edit or delete them.

Admin

Admin holds every permission, including user management, roles, and organization settings.

Platform Admin

Platform Admin holds every permission except log:admin, guardrailsYell:admin, auditLog:admin, and member:impersonate. It manages users, roles, settings, and resources, but sees only its own logs, yells, and audit records and cannot sign in as another member. Because of No Privilege Escalation, it cannot grant a role that holds the withheld permissions.

Editor

Full access to core resources, but cannot change organization settings or manage users, roles, or identity providers.

ResourceActions
Agentsread, create, delete
Skillsread, create, delete
Pluginsread, create, update, delete
Appsread, create
Guardrails Policyread, update
LLM Proxyread, update
LLM Provider API Keysread, create
LLM Virtual Keysread, create
LLM Modelsread, update
LLM Limitsread, create, update, delete
LLM Cost Analyticsread
MCP Gatewaysread, create, delete
MCP Registryread, create
MCP Server Installationsread, create, update, delete
Environmentsread, create, update, delete
Credentialsread, create
Knowledge Sourcesread, create, update, delete, query
Chatsread, create, update, delete, full-view
Projectsread, create, update, delete
LLM & MCP Logsread
Guardrails Yellsread
API Keysread, create, delete
OAuth Clientsread, create
Usersread
Rolesread
Teamsread
Identity Providersread

Member

Can manage agents, tools, and chat, with read-only access to most other resources.

ResourceActions
Agentsread, create, delete
Skillsread, create, delete
Appsread, create
LLM Proxyread
LLM Provider API Keysread
LLM Virtual Keysread, create
LLM Modelsread
MCP Gatewaysread, create, delete
MCP Registryread
MCP Server Installationsread, create, delete
Environmentsread
Credentialsread
Knowledge Sourcesread, query
Chatsread, create, update, delete, full-view
Projectsread, create, update, delete
API Keysread, create, delete
OAuth Clientsread
Teamsread

Granular Roles

Each granular role grants one slice of the permissions below, so you can give a user, team, or service account exactly the access it needs without writing a custom role. Assign as many as you like; their permissions add up. You cannot edit or delete them.

GroupRoleIdentifierPermissions
AgentsAgent Readerfixed:agents:readeragent:read
AgentsAgent Writerfixed:agents:writeragent:read, agent:create, agent:delete
SkillsSkill Readerfixed:skills:readerskill:read
SkillsSkill Writerfixed:skills:writerskill:read, skill:create, skill:delete
PluginsPlugin Readerfixed:plugins:readerplugin:read
PluginsPlugin Writerfixed:plugins:writerplugin:read, plugin:create, plugin:update, plugin:delete
AppsApp Readerfixed:apps:readerapp:read
AppsApp Writerfixed:apps:writerapp:read, app:create
GuardrailsGuardrails Readerfixed:guardrails:readerguardrailsPolicy:read
GuardrailsGuardrails Writerfixed:guardrails:writerguardrailsPolicy:read, guardrailsPolicy:update
Chat & ProjectsChat Userfixed:chat:userchat:read, chat:create, chat:update, chat:delete
Chat & ProjectsChat Full Viewfixed:chat:full-viewchat:read, chat:full-view
Chat & ProjectsProject Readerfixed:projects:readerproject:read
Chat & ProjectsProject Writerfixed:projects:writerproject:read, project:create, project:update, project:delete
KnowledgeKnowledge Readerfixed:knowledge:readerknowledgeSource:read, knowledgeSource:query
KnowledgeKnowledge Writerfixed:knowledge:writerknowledgeSource:read, knowledgeSource:create, knowledgeSource:update, knowledgeSource:delete, knowledgeSource:query
MCPMCP Gateway Readerfixed:mcp-gateways:readermcpGateway:read
MCPMCP Gateway Writerfixed:mcp-gateways:writermcpGateway:read, mcpGateway:create, mcpGateway:delete
MCPMCP Registry Readerfixed:mcp-registry:readermcpRegistry:read
MCPMCP Registry Writerfixed:mcp-registry:writermcpRegistry:read, mcpRegistry:create
MCPMCP Server Readerfixed:mcp-servers:readermcpServerInstallation:read
MCPMCP Server Writerfixed:mcp-servers:writermcpServerInstallation:read, mcpServerInstallation:create, mcpServerInstallation:update, mcpServerInstallation:delete
EnvironmentsEnvironment Readerfixed:environments:readerenvironment:read
EnvironmentsEnvironment Writerfixed:environments:writerenvironment:read, environment:create, environment:update, environment:delete
LLMLLM Proxy Readerfixed:llm-proxy:readerllmProxy:read
LLMLLM Proxy Writerfixed:llm-proxy:writerllmProxy:read, llmProxy:update
LLMProvider Key Readerfixed:llm-provider-keys:readerllmProviderApiKey:read
LLMProvider Key Writerfixed:llm-provider-keys:writerllmProviderApiKey:read, llmProviderApiKey:create
LLMVirtual Key Readerfixed:llm-virtual-keys:readerllmVirtualKey:read
LLMVirtual Key Writerfixed:llm-virtual-keys:writerllmVirtualKey:read, llmVirtualKey:create
LLMModel Readerfixed:llm-models:readerllmModel:read
LLMModel Writerfixed:llm-models:writerllmModel:read, llmModel:update
LLM Costs & LimitsCost Readerfixed:llm-costs:readerllmCost:read
LLM Costs & LimitsLimit Readerfixed:llm-limits:readerllmLimit:read
LLM Costs & LimitsLimit Writerfixed:llm-limits:writerllmLimit:read, llmLimit:create, llmLimit:update, llmLimit:delete
LLM Costs & LimitsCost Export Readerfixed:cost-exports:readercostExport:read
LLM Costs & LimitsCost Export Writerfixed:cost-exports:writercostExport:read, costExport:create, costExport:update, costExport:delete
Logs & AuditLog Readerfixed:logs:readerlog:read, guardrailsYell:read
Logs & AuditLog Adminfixed:logs:adminlog:read, log:admin, guardrailsYell:read, guardrailsYell:admin
Logs & AuditYell Readerfixed:yells:readerguardrailsYell:read
Logs & AuditYell Adminfixed:yells:adminguardrailsYell:read, guardrailsYell:admin
Logs & AuditAudit Log Readerfixed:audit-log:readerauditLog:read
Logs & AuditAudit Log Adminfixed:audit-log:adminauditLog:read, auditLog:admin
Users & TeamsUser Readerfixed:users:readermember:read
Users & TeamsUser Writerfixed:users:writermember:read, member:create, member:update, member:delete
Users & TeamsUser Impersonatorfixed:users:impersonatormember:read, member:impersonate
Users & TeamsTeam Readerfixed:teams:readerteam:read
Users & TeamsTeam Writerfixed:teams:writerteam:read, team:create, team:update, team:delete
Roles & AccessRole Readerfixed:roles:readerac:read
Roles & AccessRole Writerfixed:roles:writerac:read, ac:create, ac:update, ac:delete
Roles & AccessAccess Policy Readerfixed:access-policies:readeraccessPolicies:read
Roles & AccessAccess Policy Writerfixed:access-policies:writeraccessPolicies:read, accessPolicies:update
Roles & AccessIdentity Provider Readerfixed:identity-providers:readeridentityProvider:read
Roles & AccessIdentity Provider Writerfixed:identity-providers:writeridentityProvider:read, identityProvider:create, identityProvider:update, identityProvider:delete
API AccessAPI Key Readerfixed:api-keys:readerapiKey:read
API AccessAPI Key Writerfixed:api-keys:writerapiKey:read, apiKey:create, apiKey:delete
API AccessService Account Readerfixed:service-accounts:readerserviceAccount:read
API AccessService Account Writerfixed:service-accounts:writerserviceAccount:read, serviceAccount:create
API AccessOAuth Client Readerfixed:oauth-clients:readeroauthClient:read
API AccessOAuth Client Writerfixed:oauth-clients:writeroauthClient:read, oauthClient:create
API AccessCredential Readerfixed:credentials:readercredential:read
API AccessCredential Writerfixed:credentials:writercredential:read, credential:create
OrganizationOrganization Settings Readerfixed:organization-settings:readerorganizationSettings:read
OrganizationOrganization Settings Writerfixed:organization-settings:writerorganizationSettings:read, organizationSettings:update

Available Permissions

A custom role can hold any of these permissions. To grant an action on a single item, such as one agent, see Granular Access Control.

Agents

PermissionDescription
agent:readOpen Agents, and use the code sandboxes and files of agents you can use
agent:createCreate new agents
agent:deleteOpen the trash of deleted agents
skill:readOpen Skills
skill:createCreate new agent skills
skill:deletePermanently delete skills from the trash
plugin:readView plugins and their file metadata
plugin:createCreate plugins
plugin:updateNo standalone effect; editing a plugin requires a Can edit or Full access grant on that plugin
plugin:deleteNo standalone effect; deleting a plugin requires a Full access grant on that plugin
app:readOpen Apps
app:createCreate new MCP Apps
guardrailsPolicy:readView Guardrails policy, batteries, and coverage
guardrailsPolicy:updateValidate and edit Guardrails policy and manage batteries

MCP

PermissionDescription
mcpGateway:readOpen MCP Gateways
mcpGateway:createCreate new MCP gateways
mcpGateway:deleteOpen the trash of deleted MCP gateways
mcpRegistry:readOpen the MCP registry and use its built-in servers
mcpRegistry:createAdd servers to the MCP registry
mcpServerInstallation:readView installed MCP servers and their status
mcpServerInstallation:createInstall MCP servers from the registry
mcpServerInstallation:updateModify installed MCP server configuration
mcpServerInstallation:deleteUninstall, view deleted, and restore MCP servers within your access

LLM

PermissionDescription
llmProxy:readView the LLM Proxy and its connection details
llmProxy:updateModify LLM Proxy configuration
llmProviderApiKey:readOpen LLM provider API keys
llmProviderApiKey:createAdd new LLM provider API keys
llmVirtualKey:readOpen LLM virtual keys
llmVirtualKey:createCreate LLM virtual keys
llmModel:readView synced LLM models and capabilities
llmModel:updateSync the model catalog and see every model, including ones not shared with you
llmLimit:readView token usage limits
llmLimit:createCreate new usage limits
llmLimit:updateModify existing usage limits
llmLimit:deleteRemove usage limits
llmCost:readView organization-wide LLM usage cost statistics and analytics
costExport:readView scheduled cost exports and their run status
costExport:createSchedule cost exports to a blob provider
costExport:updateChange, pause, resume, and run cost exports
costExport:deleteDelete cost exports

Other

PermissionDescription
chat:readView and access chat conversations
chat:createStart new chat conversations
chat:updateEdit chat messages and conversation settings
chat:deleteDelete chat conversations
chat:full-viewShow the full chat: the agent picker, model and API key selectors, and expandable tool calls. Without it, chat shows a simpler view
project:readView projects, their schedules, and your own sessions inside them
project:createCreate projects and schedules, and trigger schedule runs
project:updateEdit project descriptions, instructions, sharing, and schedules
project:deleteDelete projects and schedules
knowledgeSource:readView Knowledge Bases and Connectors
knowledgeSource:createCreate Knowledge Bases and Connectors
knowledgeSource:updateModify Knowledge Bases and Connectors
knowledgeSource:deleteDelete Knowledge Bases and Connectors, view the deleted ones, and restore them
knowledgeSource:queryQuery knowledge sources for information retrieval

Logs

PermissionDescription
log:readView your own LLM proxy, MCP tool call, and Guardrails consult logs in the active organization
log:adminView every LLM, MCP, and Guardrails consult log in your organization (also requires Read)
guardrailsYell:readView and resolve the Guardrails yells of your own sessions
guardrailsYell:adminView and resolve every Guardrails yell in your organization (also requires Read)
auditLog:readView audit log records of your own administrative actions
auditLog:adminView every audit event in your organization (also requires Read)

Administration

PermissionDescription
accessPolicies:readView access policies for all resource types
accessPolicies:updateEdit access policies and grant access across all resource types
member:readView organization members and their roles
member:createAdd new members to the organization and manage invitations
member:updateChange member roles and settings
member:deleteRemove members from the organization
member:impersonateTemporarily sign in as another member to see the app with their access (role debugging)
ac:readView custom roles and their permissions
ac:createCreate new custom roles
ac:updateModify custom role permissions
ac:deleteDelete custom roles
team:readView teams and their members
team:createCreate new teams
team:updateModify team settings
team:deleteDelete teams
identityProvider:readView identity provider configurations (SSO)
identityProvider:createSet up new identity providers
identityProvider:updateModify identity provider settings
identityProvider:deleteRemove identity providers
apiKey:readView API keys
apiKey:createCreate API keys
apiKey:deleteDelete API keys
oauthClient:readOpen OAuth client registrations
oauthClient:createCreate OAuth client registrations
serviceAccount:readOpen Service Accounts
serviceAccount:createCreate service accounts
credential:readOpen Credentials
credential:createCreate saved credentials
environment:readView and list deployment environments
environment:createCreate deployment environments
environment:updateModify deployment environments, including the org default environment
environment:deleteDelete deployment environments
organizationSettings:readView every organization settings page, including messaging channels
organizationSettings:updateChange organization settings, messaging channels, and site notifications