Permissions
A request came back forbidden and you need to know exactly which permission is missing. Find it here. The console has 113 permissions, each written as object:action.
For how permissions reach a person, read Roles and permissions.
How to read the table
- Level says where the permission counts. An organization permission holds on the organization it is granted on and on every child. A tenant permission only counts when a group grants it on the root organization.
- Kind is read, write, delete, external or admin.
- API keys says whether a key may ever carry the permission. When it says No, only a signed-in person can use it.
- Destructive marks actions you cannot take back.
The catalog also covers features that are still in preview, such as Guard Center, Report Center and Tests Center. Holding a permission does not mean the feature behind it is available to you yet.
All permissions
| Permission | What it allows | Level | Kind | API keys | Destructive |
|---|---|---|---|---|---|
ai.settings:read | See Dwaar AI settings: mode, tiers, budget and recent runs (never a credential) | Tenant | Read | Yes | No |
ai.settings:update | Change Dwaar AI settings, credentials, tier bindings and the budget | Tenant | Admin | No | No |
ai:use | Use Dwaar AI on what you can see: summaries, explanations and drafts | Org | External | No | No |
api_keys:read | See every API key in the tenant | Tenant | Read | Yes | No |
api_keys:revoke | Revoke someone else's API key | Tenant | Admin | No | No |
audit:export | Export the audit log | Tenant | Read | Yes | No |
audit:read | Read the audit log | Tenant | Read | Yes | No |
billing:read | See plan, usage and invoices | Tenant | Read | Yes | No |
billing:update | Change plan, billing contact and payment method | Tenant | Admin | No | No |
break:read | See Break readiness | Org | Read | Yes | No |
discovery:cancel | Cancel discovery | Org | Write | Yes | No |
discovery:read | See discovery jobs and schedules | Org | Read | Yes | No |
discovery:run | Run discovery | Org | Write | Yes | No |
findings.settings:update | Change Finding Configurations: which findings the data pipeline ignores | Tenant | Write | No | No |
findings:accept_risk | Accept risk on findings | Org | Write | Yes | No |
findings:create_ticket | File tickets for findings | Org | External | Yes | No |
findings:delete | Delete findings | Org | Delete | Yes | Yes |
findings:export | Export findings | Org | Read | Yes | No |
findings:open_pr | Open fix pull requests | Org | External | Yes | No |
findings:read | See findings | Org | Read | Yes | No |
findings:rotate_secret | Rotate leaked secrets | Org | External | Yes | Yes |
findings:update | Waive findings, override severity and comment on them | Org | Write | Yes | No |
fixes:create | Create fix campaigns | Org | Write | Yes | No |
fixes:delete | Archive and delete fixes | Org | Delete | Yes | Yes |
fixes:read | See fixes and campaigns | Org | Read | Yes | No |
groups.members:update | Add and remove members of groups | Tenant | Admin | No | No |
groups:create | Create groups | Tenant | Admin | No | No |
groups:delete | Delete groups | Tenant | Admin | No | No |
groups:read | See groups | Tenant | Read | Yes | No |
groups:update | Change a group's name, role and organizations | Tenant | Admin | No | No |
guard.deployments:read | See deployed guards | Org | Read | Yes | No |
guard.events:read | See guard events | Org | Read | Yes | No |
guard.exceptions:approve | Approve, reject and revoke guard exceptions | Org | Write | Yes | No |
guard.exceptions:create | Request guard exceptions | Org | Write | Yes | No |
guard.exceptions:read | See guard exceptions | Org | Read | Yes | No |
guard.exceptions:update | Change, archive and restore guard exceptions | Org | Write | Yes | No |
guard.policies:create | Create guard policies in observe or audit | Org | Write | Yes | No |
guard.policies:delete | Delete guard policies | Org | Delete | Yes | Yes |
guard.policies:enforce | Put guard policies in enforce | Org | Write | Yes | No |
guard.policies:export | Export guard policies | Org | Read | Yes | No |
guard.policies:import | Import Rego policies | Org | Write | Yes | No |
guard.policies:read | See guard policies, controls and imports | Org | Read | Yes | No |
guard.policies:update | Change, archive and restore guard policies | Org | Write | Yes | No |
guard.settings:update | Change guard settings per resource type | Tenant | Write | No | No |
guard.tokens:create | Create guard install tokens | Org | Admin | No | No |
integrations.routing:update | Change notification routing | Org | Write | Yes | No |
integrations:create | Connect integrations (stores credentials) | Org | Write | No | No |
integrations:delete | Delete integrations | Org | Delete | No | Yes |
integrations:read | See integrations, imports and routing | Org | Read | Yes | No |
integrations:sync | Sync integrations and run imports | Org | Write | Yes | No |
integrations:test | Test integrations and verify domains | Org | External | Yes | No |
integrations:update | Change, archive and restore integrations | Org | Write | No | No |
members:invite | Invite members, resend and revoke invites | Tenant | Admin | No | No |
members:read | See members and invites | Tenant | Read | Yes | No |
members:remove | Remove members | Tenant | Admin | No | No |
members:update | Suspend and reactivate members | Tenant | Admin | No | No |
orgs:create | Create child organizations | Org | Write | Yes | No |
orgs:delete | Delete organizations | Org | Delete | Yes | Yes |
orgs:update | Rename and move organizations | Org | Write | Yes | No |
products.versions:create | Snapshot product versions | Org | Write | Yes | No |
products.versions:read | See product versions | Org | Read | Yes | No |
products.versions:update | Change product versions | Org | Write | Yes | No |
products:create | Create products | Org | Write | Yes | No |
products:delete | Delete products | Org | Delete | Yes | Yes |
products:read | See products | Org | Read | Yes | No |
products:update | Change, archive and restore products | Org | Write | Yes | No |
query:run | Ask questions over your data (answers follow your read access) | Org | Read | Yes | No |
reports.schedules:create | Create report schedules | Org | Write | Yes | No |
reports.schedules:delete | Delete report schedules | Org | Delete | Yes | Yes |
reports.schedules:read | See report schedules | Org | Read | Yes | No |
reports.schedules:update | Change report schedules | Org | Write | Yes | No |
reports:delete | Archive and delete report runs | Org | Delete | Yes | Yes |
reports:download | Download reports | Org | Read | Yes | No |
reports:generate | Generate and regenerate reports | Org | Write | Yes | No |
reports:read | See reports | Org | Read | Yes | No |
resources.connector:read | See connectors (env names only, never secrets) | Org | Read | Yes | No |
resources.connector:test | Test connectors from the Outpost | Org | External | Yes | No |
resources.connector:update | Change connectors | Org | Write | Yes | No |
resources.lineage:update | Link and unlink resources | Org | Write | Yes | No |
resources.vendor:request_documents | Email vendors for documents | Org | External | Yes | No |
resources:attach | Attach resources to products and detach them | Org | Write | Yes | No |
resources:create | Upload specs and vendor SBOMs | Org | Write | Yes | No |
resources:delete | Delete resources | Org | Delete | Yes | Yes |
resources:read | See resources, lineage and SBOMs | Org | Read | Yes | No |
resources:update | Change, archive and restore resources | Org | Write | Yes | No |
roles:create | Create custom roles | Tenant | Admin | No | No |
roles:delete | Delete custom roles | Tenant | Admin | No | No |
roles:read | See roles | Tenant | Read | Yes | No |
roles:update | Change custom roles | Tenant | Admin | No | No |
scanners:read | See scanners | Org | Read | Yes | No |
scanners:run | Run scanners | Org | Write | Yes | No |
scanners:update | Configure scanners | Org | Write | Yes | No |
scans:cancel | Cancel scans | Org | Write | Yes | No |
scans:delete | Delete scans | Org | Delete | Yes | Yes |
scans:read | See scans | Org | Read | Yes | No |
scans:run | Run and retry scans | Org | Write | Yes | No |
scans:update | Change scan priority and order | Org | Write | Yes | No |
security:read | See security settings, everyone's sessions and sign-in history | Tenant | Read | Yes | No |
security:update | Change SSO, 2FA and session settings | Tenant | Admin | No | No |
service_accounts:create | Create service accounts | Tenant | Admin | No | No |
service_accounts:delete | Delete service accounts | Tenant | Admin | No | No |
service_accounts:read | See service accounts | Tenant | Read | Yes | No |
service_accounts:update | Change service accounts and their keys | Tenant | Admin | No | No |
sessions:revoke | Revoke someone else's session | Tenant | Admin | No | No |
settings:update | Change general settings | Tenant | Admin | No | No |
tenant:delete | Delete the tenant | Tenant | Admin | No | No |
tests.settings:update | Change Tests Center settings | Tenant | Admin | No | No |
tests:approve | Approve, reject or send back tests | Org | Write | Yes | No |
tests:create | Create tests | Org | Write | Yes | No |
tests:delete | Archive and delete tests | Org | Delete | Yes | Yes |
tests:read | See tests, runs and vectors | Org | Read | Yes | No |
tests:run | Run, pause, resume, cancel and retest tests | Org | External | Yes | No |
tests:update | Change test context and plans, submit them | Org | Write | Yes | No |
Which role holds what
Admin is Administrator, Sec is Security admin, AppSec is AppSec engineer, Dev is Developer, Appr is Approver, View is Viewer, Audit is Auditor, Bill is Billing admin, CI is CI pipeline.
| Permission | Admin | Sec | AppSec | Dev | Appr | View | Audit | Bill | CI |
|---|---|---|---|---|---|---|---|---|---|
ai.settings:read | Yes | Yes | Yes | Yes | |||||
ai.settings:update | Yes | ||||||||
ai:use | Yes | Yes | Yes | Yes | |||||
api_keys:read | Yes | Yes | Yes | ||||||
api_keys:revoke | Yes | ||||||||
audit:export | Yes | Yes | |||||||
audit:read | Yes | Yes | Yes | ||||||
billing:read | Yes | Yes | Yes | ||||||
billing:update | Yes | Yes | |||||||
break:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
discovery:cancel | Yes | Yes | Yes | ||||||
discovery:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
discovery:run | Yes | Yes | Yes | ||||||
findings.settings:update | Yes | Yes | |||||||
findings:accept_risk | Yes | Yes | Yes | Yes | |||||
findings:create_ticket | Yes | Yes | Yes | Yes | |||||
findings:delete | Yes | Yes | |||||||
findings:export | Yes | Yes | Yes | Yes | |||||
findings:open_pr | Yes | Yes | Yes | Yes | |||||
findings:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
findings:rotate_secret | Yes | Yes | |||||||
findings:update | Yes | Yes | Yes | Yes | |||||
fixes:create | Yes | Yes | Yes | Yes | |||||
fixes:delete | Yes | Yes | |||||||
fixes:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
groups.members:update | Yes | ||||||||
groups:create | Yes | ||||||||
groups:delete | Yes | ||||||||
groups:read | Yes | Yes | Yes | ||||||
groups:update | Yes | ||||||||
guard.deployments:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
guard.events:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
guard.exceptions:approve | Yes | Yes | Yes | ||||||
guard.exceptions:create | Yes | Yes | Yes | ||||||
guard.exceptions:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
guard.exceptions:update | Yes | Yes | Yes | ||||||
guard.policies:create | Yes | Yes | Yes | ||||||
guard.policies:delete | Yes | Yes | |||||||
guard.policies:enforce | Yes | Yes | Yes | ||||||
guard.policies:export | Yes | Yes | Yes | ||||||
guard.policies:import | Yes | Yes | Yes | ||||||
guard.policies:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
guard.policies:update | Yes | Yes | Yes | ||||||
guard.settings:update | Yes | Yes | |||||||
guard.tokens:create | Yes | Yes | |||||||
integrations.routing:update | Yes | Yes | |||||||
integrations:create | Yes | Yes | |||||||
integrations:delete | Yes | Yes | |||||||
integrations:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
integrations:sync | Yes | Yes | Yes | ||||||
integrations:test | Yes | Yes | Yes | ||||||
integrations:update | Yes | Yes | |||||||
members:invite | Yes | ||||||||
members:read | Yes | Yes | Yes | Yes | |||||
members:remove | Yes | ||||||||
members:update | Yes | ||||||||
orgs:create | Yes | Yes | |||||||
orgs:delete | Yes | Yes | |||||||
orgs:update | Yes | Yes | |||||||
products.versions:create | Yes | Yes | Yes | ||||||
products.versions:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
products.versions:update | Yes | Yes | Yes | ||||||
products:create | Yes | Yes | Yes | ||||||
products:delete | Yes | Yes | |||||||
products:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
products:update | Yes | Yes | Yes | ||||||
query:run | Yes | Yes | Yes | Yes | |||||
reports.schedules:create | Yes | Yes | Yes | ||||||
reports.schedules:delete | Yes | Yes | Yes | ||||||
reports.schedules:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
reports.schedules:update | Yes | Yes | Yes | ||||||
reports:delete | Yes | Yes | |||||||
reports:download | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
reports:generate | Yes | Yes | Yes | ||||||
reports:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
resources.connector:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
resources.connector:test | Yes | Yes | Yes | ||||||
resources.connector:update | Yes | Yes | Yes | ||||||
resources.lineage:update | Yes | Yes | Yes | ||||||
resources.vendor:request_documents | Yes | Yes | Yes | ||||||
resources:attach | Yes | Yes | Yes | ||||||
resources:create | Yes | Yes | Yes | Yes | |||||
resources:delete | Yes | Yes | |||||||
resources:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
resources:update | Yes | Yes | Yes | ||||||
roles:create | Yes | ||||||||
roles:delete | Yes | ||||||||
roles:read | Yes | Yes | Yes | ||||||
roles:update | Yes | ||||||||
scanners:read | Yes | Yes | Yes | Yes | Yes | Yes | |||
scanners:run | Yes | Yes | Yes | ||||||
scanners:update | Yes | Yes | |||||||
scans:cancel | Yes | Yes | Yes | ||||||
scans:delete | Yes | Yes | |||||||
scans:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
scans:run | Yes | Yes | Yes | Yes | Yes | ||||
scans:update | Yes | Yes | Yes | ||||||
security:read | Yes | Yes | |||||||
security:update | Yes | ||||||||
service_accounts:create | Yes | ||||||||
service_accounts:delete | Yes | ||||||||
service_accounts:read | Yes | Yes | Yes | ||||||
service_accounts:update | Yes | ||||||||
sessions:revoke | Yes | ||||||||
settings:update | Yes | ||||||||
tenant:delete | Yes | ||||||||
tests.settings:update | Yes | Yes | |||||||
tests:approve | Yes | Yes | Yes | ||||||
tests:create | Yes | Yes | Yes | ||||||
tests:delete | Yes | Yes | |||||||
tests:read | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ||
tests:run | Yes | Yes | Yes | ||||||
tests:update | Yes | Yes | Yes |
API key presets
A preset is a named list of permissions for a key. A key still never does more than its owner can do when it is used.
CI pipeline
findings:read, guard.events:read, guard.policies:read, reports:download, resources:create, resources:read, scans:read, scans:run.
Read only (MCP)
break:read, discovery:read, findings:read, fixes:read, guard.deployments:read, guard.events:read, guard.exceptions:read, guard.policies:read, integrations:read, products.versions:read, products:read, reports.schedules:read, reports:download, reports:read, resources.connector:read, resources:read, scanners:read, scans:read, tests:read.
Try this next
Copy the row of permissions you actually need into a custom role rather than handing out Security admin.