You are viewing the docs for Archestra v1.4. View the latest docs
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, auditLog:admin, and member:impersonate. It manages users, roles, settings, and resources, but sees only its own logs 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.
| Resource | Actions |
|---|---|
| Agents | read, create, delete |
| Skills | read, create, delete |
| Plugins | read, create, update, delete |
| Apps | read, create |
| Guardrails Policy | read, update |
| LLM Proxy | read, update |
| LLM Provider API Keys | read, create |
| LLM Virtual Keys | read, create |
| LLM Models | read, update |
| LLM Limits | read, create, update, delete |
| LLM Cost Analytics | read |
| MCP Gateways | read, create, delete |
| MCP Registry | read, create |
| MCP Server Installations | read, create, update, delete |
| Environments | read, create, update, delete |
| Credentials | read, create |
| Knowledge Sources | read, create, update, delete, query |
| Chats | read, create, update, delete, full-view |
| Projects | read, create, update, delete |
| LLM & MCP Logs | read |
| API Keys | read, create, delete |
| OAuth Clients | read, create |
| Users | read |
| Roles | read |
| Teams | read |
| Identity Providers | read |
Member
Can manage agents, tools, and chat, with read-only access to most other resources.
| Resource | Actions |
|---|---|
| Agents | read, create, delete |
| Skills | read, create, delete |
| Apps | read, create |
| LLM Proxy | read |
| LLM Provider API Keys | read |
| LLM Virtual Keys | read, create |
| LLM Models | read |
| MCP Gateways | read, create, delete |
| MCP Registry | read |
| MCP Server Installations | read, create, delete |
| Environments | read |
| Credentials | read |
| Knowledge Sources | read, query |
| Chats | read, create, update, delete, full-view |
| Projects | read, create, update, delete |
| API Keys | read, create, delete |
| OAuth Clients | read |
| Teams | read |
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.
| Permission | Description |
|---|---|
ac:read | View custom roles and their permissions |
ac:create | Create new custom roles |
ac:update | Modify custom role permissions |
ac:delete | Delete custom roles |
accessPolicies:read | View access policies for all resource types |
accessPolicies:update | Edit access policies and grant access across all resource types |
agent:read | Open Agents, and use the code sandboxes and files of agents you can use |
agent:create | Create new agents |
agent:delete | Open the trash of deleted agents |
agent:configure-runtime | Create runtime-backed agents and change or remove their runtime configuration |
apiKey:read | View API keys |
apiKey:create | Create API keys |
apiKey:delete | Delete API keys |
app:read | Open Apps |
app:create | Create new MCP Apps |
auditLog:read | View audit log records of your own administrative actions |
auditLog:admin | View every audit event in your organization (also requires Read) |
chat:read | View and access chat conversations |
chat:create | Start new chat conversations |
chat:update | Edit chat messages and conversation settings |
chat:delete | Delete chat conversations |
chat:full-view | Show the full chat: the agent picker, model and API key selectors, and expandable tool calls. Without it, chat shows a simpler view |
credential:read | Open Credentials |
credential:create | Create saved credentials |
environment:read | View and list deployment environments |
environment:create | Create deployment environments |
environment:update | Modify deployment environments, including the org default environment |
environment:delete | Delete deployment environments |
guardrailsPolicy:read | View Guardrails policy, batteries, and coverage |
guardrailsPolicy:update | Validate and edit Guardrails policy and manage batteries |
identityProvider:read | View identity provider configurations (SSO) |
identityProvider:create | Set up new identity providers |
identityProvider:update | Modify identity provider settings |
identityProvider:delete | Remove identity providers |
knowledgeSource:read | View Knowledge Bases and Connectors |
knowledgeSource:create | Create Knowledge Bases and Connectors |
knowledgeSource:update | Modify Knowledge Bases and Connectors |
knowledgeSource:delete | Delete Knowledge Bases and Connectors, view the deleted ones, and restore them |
knowledgeSource:query | Query knowledge sources for information retrieval |
llmCost:read | View organization-wide LLM usage cost statistics and analytics |
llmLimit:read | View token usage limits |
llmLimit:create | Create new usage limits |
llmLimit:update | Modify existing usage limits |
llmLimit:delete | Remove usage limits |
llmModel:read | View synced LLM models and capabilities |
llmModel:update | Sync the model catalog and see every model, including ones not shared with you |
llmProviderApiKey:read | Open LLM provider API keys |
llmProviderApiKey:create | Add new LLM provider API keys |
llmProxy:read | View the LLM Proxy and its connection details |
llmProxy:update | Modify LLM Proxy configuration |
llmVirtualKey:read | Open LLM virtual keys |
llmVirtualKey:create | Create LLM virtual keys |
log:read | View your own LLM proxy, MCP tool call, and Guardrails consult logs in the active organization, and view and resolve your own Guardrails yells |
log:admin | View every LLM, MCP, and Guardrails consult log and yell in your organization (also requires Read) |
mcpGateway:read | Open MCP Gateways |
mcpGateway:create | Create new MCP gateways |
mcpGateway:delete | Open the trash of deleted MCP gateways |
mcpRegistry:read | Open the MCP registry and use its built-in servers |
mcpRegistry:create | Add servers to the MCP registry |
mcpServerInstallation:read | View installed MCP servers and their status |
mcpServerInstallation:create | Install MCP servers from the registry |
mcpServerInstallation:update | Modify installed MCP server configuration |
mcpServerInstallation:delete | Uninstall, view deleted, and restore MCP servers within your access |
member:read | View organization members and their roles |
member:create | Add new members to the organization and manage invitations |
member:update | Change member roles and settings |
member:delete | Remove members from the organization |
member:impersonate | Temporarily sign in as another member to see the app with their access (role debugging) |
oauthClient:read | Open OAuth client registrations |
oauthClient:create | Create OAuth client registrations |
organizationSettings:read | View every organization settings page, including messaging channels |
organizationSettings:update | Change organization settings, messaging channels, and site notifications |
plugin:read | View plugins and their file metadata |
plugin:create | Create plugins |
plugin:update | Modify plugin metadata and files |
plugin:delete | Delete plugins |
project:read | View projects, their schedules, and your own sessions inside them |
project:create | Create projects and schedules, and trigger schedule runs |
project:update | Edit project descriptions, instructions, sharing, and schedules |
project:delete | Delete projects and schedules |
serviceAccount:read | Open Service Accounts |
serviceAccount:create | Create service accounts |
skill:read | Open Skills |
skill:create | Create new agent skills |
skill:delete | Permanently delete skills from the trash |
team:read | View teams and their members |
team:create | Create new teams |
team:update | Modify team settings |
team:delete | Delete teams |