> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Permission reference

> Every Forge permission: its key, what it lets someone do, whether giving it needs an opt-in, and which roles include it. Generated from the permission catalog.

Every Forge permission is a verb on a resource, written `resource:verb`, and belongs to one of six
families. Roles bundle permissions; a role grant gives someone a role at a scope. In the Console,
every permission has its own page under [Trust Fabric → Access](https://docs.gloo.com/forge/console/trust-fabric/access).

An **elevated** permission needs an explicit opt-in before it is given. **Included in** lists the
standard roles that include the permission.

## Verbs

| Verb | In the Console | Meaning |
| - | - | - |
| `read` | See | See it. |
| `use` | Use | Run or call it. |
| `write` | Edit | Create and edit it. |
| `manage` | Manage | Delete, configure, give to others. |
| `approve` | Approve | Release a hold on it. |

## Build

Make what Forge runs: agents, workflows, procedures, skills, tools and what they know.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See agents | `agents:read` | See agents and their settings. | | Base, Builder, Operator, Auditor, Platform admin |
| Use agents | `agents:use` | Chat with an agent or dispatch it ad hoc. | | Base, Builder, Operator, Platform admin |
| Edit agents | `agents:write` | Create agents and edit their prompts, tools and settings. | | Builder, Operator, Platform admin |
| Manage agents | `agents:manage` | Delete agents, set their autonomy rung, give them tool grants and activate their versions. | | Operator, Platform admin |
| See workflows | `workflows:read` | See workflows and their versions. | | Base, Builder, Operator, Auditor, Platform admin |
| Use workflows | `workflows:use` | Start a run of a published workflow. | | Builder, Operator, Platform admin |
| Edit workflows | `workflows:write` | Create and edit drafts, including Credential bindings the editor is entitled to. | | Builder, Operator, Platform admin |
| Manage workflows | `workflows:manage` | Publish, roll back, retire, and set schedules and other triggers. | Yes | Operator, Platform admin |
| See procedures | `procedures:read` | See procedures, their code and their judged versions. | | Base, Builder, Operator, Auditor, Platform admin |
| Use procedures | `procedures:use` | Run a procedure by hand. | | Builder, Operator, Platform admin |
| Edit procedures | `procedures:write` | Write new procedures and edit the code of existing ones. | | Builder, Operator, Platform admin |
| Manage procedures | `procedures:manage` | Retire and delete procedures, and change a procedure's declaration to lower its risk. | | Operator, Platform admin |
| Approve procedures | `procedures:approve` | Promote a judged procedure, and ask for it to be judged again. | Yes | Platform admin |
| See skills | `skills:read` | See skills and the sets they are organized into. | | Base, Builder, Operator, Auditor, Platform admin |
| Edit skills | `skills:write` | Write new skills and edit the instructions in existing ones. | | Builder, Operator, Platform admin |
| Manage skills | `skills:manage` | Publish and delete skills, and organize them into sets. | | Operator, Platform admin |
| See tools | `tools:read` | See tools and the declarations that set each one's risk. | | Base, Directory reader, Builder, Operator, Auditor, Platform admin |
| Edit tools | `tools:write` | Create and edit tools and their declarations. | | Tool author, Platform admin |
| Manage tools | `tools:manage` | Delete tools; change a declaration that lowers its risk. | | Tool author, Platform admin |
| See knowledge | `knowledge:read` | Search and read what is in the knowledge bases. | | Base, Builder, Operator, Auditor, Customer knowledge reader, Platform admin |
| Edit knowledge | `knowledge:write` | Add knowledge to knowledge bases and edit what is there. | | Builder, Operator, Platform admin |
| Manage knowledge | `knowledge:manage` | Delete and configure knowledge bases. | | Operator, Platform admin |
| See memory | `memory:read` | See what agents remember between conversations and runs. | | Builder, Operator, Auditor, Platform admin |
| Edit memory | `memory:write` | Add to and change what agents remember between conversations and runs. | | Builder, Operator, Platform admin |
| See files | `files:read` | Open and read the files people and agents keep in Forge. | | Base, Builder, Operator, Auditor, Platform admin |
| Edit files | `files:write` | Upload files to Forge for people and agents to use. | | Base, Builder, Operator, Platform admin |
| Use synthesis | `synthesis:use` | Ask Forge to synthesize a new primitive. | | Builder, Operator, Platform admin |
| Manage synthesis | `synthesis:manage` | Set synthesis budgets and templates. | | Platform admin |
| Approve synthesis | `synthesis:approve` | Approve a primitive Forge synthesized, so it can be used. | Yes | Operator, Platform admin |
| Use judges | `judges:use` | Dispatch a judge to score a piece of work. | | Builder, Operator, Platform admin |
| Manage judges | `judges:manage` | Promote and demote judges, choosing which judge scores each check. | | Operator, Platform admin |

## Run

Run work and take part in it: runs, chat, approvals, human tasks, events and webhooks.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See runs | `runs:read` | See runs and their results. | | Base, Builder, Operator, Auditor, Platform admin |
| Manage runs | `runs:manage` | Resume, cancel and retry a run. Separate from starting one, so a credential that may only resume can never start. | | Operator, Platform admin |
| See chat | `chat:read` | See channels and the conversations in them. | | Base, Builder, Operator, Auditor, Platform admin |
| Use chat | `chat:use` | Join channels and take part in their conversations. | | Base, Builder, Operator, Platform admin |
| Manage chat | `chat:manage` | Create and configure channels, including the company a channel acts for. | | Operator, Platform admin |
| See approvals | `approvals:read` | See the approvals and human tasks waiting on you. | | Operator, Company admin, Auditor, Platform admin |
| Approve approvals | `approvals:approve` | Release or reject a hold — only one you could have done yourself in that scope. Your own included, unless its policy requires a different approver. | Yes | Operator, Company admin, Platform admin |
| Use human tasks | `human_tasks:use` | Ask named people for a decision or input through a human task, read the answer, and withdraw your own asks. People answer by being asked, never by holding this. | | Platform admin |
| See events | `events:read` | See the record of platform events that webhooks and triggers listen to. | | Builder, Operator, Auditor, Platform admin |
| See webhooks | `webhooks:read` | See webhooks and the events each one sends. | | Operator, Auditor, Platform admin |
| Manage webhooks | `webhooks:manage` | Create, edit and delete webhooks. | | Operator, Platform admin |

## Connect

Reach outside systems: vendors, Connections, Credentials, apps, API keys and models.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See vendors | `vendors:read` | See the vendors whose systems Forge can connect to. | | Directory reader, Auditor, Platform admin |
| Edit vendors | `vendors:write` | Add vendors and edit their details. | | Tool author, Platform admin |
| Manage vendors | `vendors:manage` | Delete vendors Forge no longer connects to. | | Platform admin |
| See connections | `connections:read` | See Connections and how each one reaches its vendor's system. | | Directory reader, Auditor, Platform admin |
| Manage connections | `connections:manage` | Create, edit and delete Connections. | | Platform admin |
| See credentials | `credentials:read` | See that a Credential exists, its scope and its health. Never the secret. | | Builder, Credential user, Operator, Company admin, Auditor, Platform admin |
| Use credentials | `credentials:use` | Bind a Credential into a workflow or an agent, or use it in ad hoc work. Given for a company's scope, this is the one thing that lets a person or an API key use that company's Credentials (decision 23). | | Credential user, Company admin, Platform admin |
| Edit credentials | `credentials:write` | Create a Credential and rotate it. | Yes | Company admin, Platform admin |
| Manage credentials | `credentials:manage` | Share a Credential down to the companies below its scope, change its scope, or delete it. | Yes | Company admin, Platform admin |
| Approve credentials | `credentials:approve` | Approve a requested Credential. Never the person who requested it. | Yes | Company admin, Platform admin |
| See external apps | `apps:read` | See external apps and their settings. | | Company admin, Auditor, Platform admin |
| Manage external apps | `apps:manage` | Create, edit and delete external apps. | | Company admin, Platform admin |
| See API keys | `apikeys:read` | See API keys. Never the secret. | | Company admin, Auditor, Platform admin |
| Manage API keys | `apikeys:manage` | Create and revoke API keys. Giving a key a role takes grants:manage, like giving one to anyone. | Yes | Company admin, Platform admin |
| Use models | `inference:use` | Call a model through Forge's gateway. | | Builder, Model user, Operator, Platform admin |

## Govern

Decide who may do what and keep the record: roles, access, policies, stops and audit.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See roles | `roles:read` | See roles and what they contain. | | Base, Directory reader, Builder, Operator, Auditor, Platform admin |
| Manage roles | `roles:manage` | Create, edit and delete roles. Adding a permission to a role requires holding it yourself. Platform scope only. | Yes | Platform admin |
| See access | `grants:read` | See who holds what, and why. | | Operator, Company admin, Auditor, Platform admin |
| Manage access | `grants:manage` | Give and revoke grants. You may only give a role whose every permission you hold for a covering scope, and never to yourself. | Yes | Company admin, Platform admin |
| See policies | `policies:read` | See policies and whether each one is enabled. | | Directory reader, Auditor, Platform admin |
| Manage policies | `policies:manage` | Create, edit, enable and disable policies. | Yes | Platform admin |
| See emergency stops | `switches:read` | See whether each switch is on or off. | | Directory reader, Auditor, Platform admin |
| Use emergency stops | `switches:use` | Throw a switch: pause an agent, stop a door, stop everything. | Yes | Platform admin |
| See audit records | `audit:read` | Read and export the record. Every export is itself recorded. | | Operator, Company admin, Auditor, Platform admin |

## Org

Lay out the organization: org units, people, projects, customers and objectives.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See organization | `org:read` | See the org chart and the org units in it. | | Base, Builder, Operator, Auditor, Platform admin |
| Manage organization | `org:manage` | Edit the org chart and the org units in it. | | Platform admin |
| See people and positions | `workforce:read` | See the people in the organization and their positions. | | Operator, Auditor, Platform admin |
| Manage people and positions | `workforce:manage` | Edit people, positions and assignments. | | Platform admin |
| See projects | `projects:read` | See projects and who is a member of each. | | Base, Builder, Operator, Auditor, Platform admin |
| Manage projects | `projects:manage` | Create, edit and delete projects; add and remove project members. | | Platform admin |
| See customers | `customers:read` | See the customer records a company keeps in Forge. | | Operator, Auditor, Customer knowledge reader, Platform admin |
| Manage customers | `customers:manage` | Create customer records and edit their details. | | Platform admin |
| See service desk | `service_desk:read` | See mirrored service desk tickets and the client health board. | | Operator, Auditor, Customer knowledge reader, Platform admin |
| See objectives | `objectives:read` | See objectives and the outcomes work is measured against. | | Base, Builder, Operator, Auditor, Platform admin |
| Manage objectives | `objectives:manage` | Define outcomes and bind them. | | Platform admin |

## Platform

Run Forge itself: settings, cost, environments, vaults, secrets, gateway and factories.

| Permission | Key | What it lets someone do | Elevated | Included in |
| - | - | - | - | - |
| See platform settings | `platform:read` | See platform health, settings and runtime logs. | | Directory reader, Auditor, Platform admin |
| Manage platform settings | `platform:manage` | Change platform settings. What is left of the old all-purpose admin permission once Credentials, grants and switches have their own. | Yes | Platform admin |
| See cost | `cost:read` | See what Forge spends on models and runs, and its budgets. | | Operator, Auditor, Platform admin |
| Manage cost | `cost:manage` | Set the budgets and freezes that limit what Forge spends. | Yes | Platform admin |
| See environments | `environments:read` | See environments and how each one is configured. | | Auditor, Platform admin |
| Manage environments | `environments:manage` | Create, deploy and configure environments. | Yes | Platform admin |
| See vaults | `vaults:read` | See vaults and who belongs to them. | | Auditor, Platform admin |
| Manage vaults | `vaults:manage` | Create vaults, manage members and mappings. | Yes | Platform admin |
| See secrets | `secrets:read` | See that a secret exists and its version history. Never the value. | | Platform admin |
| Manage secrets | `secrets:manage` | Create platform secrets and rotate their values. | Yes | Platform admin |
| See model gateway | `gateway:read` | See the model gateway's providers, routing and model prices. | | Auditor, Platform admin |
| Manage model gateway | `gateway:manage` | Configure providers and routing, and record model prices. | Yes | Platform admin |
| See factories | `factories:read` | See factories, their tasks and their sandbox history. | | Auditor, Platform admin |
| Manage factories | `factories:manage` | Create and configure factories, manage their tasks, message their manager agent, and replay sandbox commands. | | Platform admin |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.