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.
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 |

