Skip to main content

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

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​

PermissionWhat it allowsLevelKindAPI keysDestructive
ai.settings:readSee Dwaar AI settings: mode, tiers, budget and recent runs (never a credential)TenantReadYesNo
ai.settings:updateChange Dwaar AI settings, credentials, tier bindings and the budgetTenantAdminNoNo
ai:useUse Dwaar AI on what you can see: summaries, explanations and draftsOrgExternalNoNo
api_keys:readSee every API key in the tenantTenantReadYesNo
api_keys:revokeRevoke someone else's API keyTenantAdminNoNo
audit:exportExport the audit logTenantReadYesNo
audit:readRead the audit logTenantReadYesNo
billing:readSee plan, usage and invoicesTenantReadYesNo
billing:updateChange plan, billing contact and payment methodTenantAdminNoNo
break:readSee Break readinessOrgReadYesNo
discovery:cancelCancel discoveryOrgWriteYesNo
discovery:readSee discovery jobs and schedulesOrgReadYesNo
discovery:runRun discoveryOrgWriteYesNo
findings.settings:updateChange Finding Configurations: which findings the data pipeline ignoresTenantWriteNoNo
findings:accept_riskAccept risk on findingsOrgWriteYesNo
findings:create_ticketFile tickets for findingsOrgExternalYesNo
findings:deleteDelete findingsOrgDeleteYesYes
findings:exportExport findingsOrgReadYesNo
findings:open_prOpen fix pull requestsOrgExternalYesNo
findings:readSee findingsOrgReadYesNo
findings:rotate_secretRotate leaked secretsOrgExternalYesYes
findings:updateWaive findings, override severity and comment on themOrgWriteYesNo
fixes:createCreate fix campaignsOrgWriteYesNo
fixes:deleteArchive and delete fixesOrgDeleteYesYes
fixes:readSee fixes and campaignsOrgReadYesNo
groups.members:updateAdd and remove members of groupsTenantAdminNoNo
groups:createCreate groupsTenantAdminNoNo
groups:deleteDelete groupsTenantAdminNoNo
groups:readSee groupsTenantReadYesNo
groups:updateChange a group's name, role and organizationsTenantAdminNoNo
guard.deployments:readSee deployed guardsOrgReadYesNo
guard.events:readSee guard eventsOrgReadYesNo
guard.exceptions:approveApprove, reject and revoke guard exceptionsOrgWriteYesNo
guard.exceptions:createRequest guard exceptionsOrgWriteYesNo
guard.exceptions:readSee guard exceptionsOrgReadYesNo
guard.exceptions:updateChange, archive and restore guard exceptionsOrgWriteYesNo
guard.policies:createCreate guard policies in observe or auditOrgWriteYesNo
guard.policies:deleteDelete guard policiesOrgDeleteYesYes
guard.policies:enforcePut guard policies in enforceOrgWriteYesNo
guard.policies:exportExport guard policiesOrgReadYesNo
guard.policies:importImport Rego policiesOrgWriteYesNo
guard.policies:readSee guard policies, controls and importsOrgReadYesNo
guard.policies:updateChange, archive and restore guard policiesOrgWriteYesNo
guard.settings:updateChange guard settings per resource typeTenantWriteNoNo
guard.tokens:createCreate guard install tokensOrgAdminNoNo
integrations.routing:updateChange notification routingOrgWriteYesNo
integrations:createConnect integrations (stores credentials)OrgWriteNoNo
integrations:deleteDelete integrationsOrgDeleteNoYes
integrations:readSee integrations, imports and routingOrgReadYesNo
integrations:syncSync integrations and run importsOrgWriteYesNo
integrations:testTest integrations and verify domainsOrgExternalYesNo
integrations:updateChange, archive and restore integrationsOrgWriteNoNo
members:inviteInvite members, resend and revoke invitesTenantAdminNoNo
members:readSee members and invitesTenantReadYesNo
members:removeRemove membersTenantAdminNoNo
members:updateSuspend and reactivate membersTenantAdminNoNo
orgs:createCreate child organizationsOrgWriteYesNo
orgs:deleteDelete organizationsOrgDeleteYesYes
orgs:updateRename and move organizationsOrgWriteYesNo
products.versions:createSnapshot product versionsOrgWriteYesNo
products.versions:readSee product versionsOrgReadYesNo
products.versions:updateChange product versionsOrgWriteYesNo
products:createCreate productsOrgWriteYesNo
products:deleteDelete productsOrgDeleteYesYes
products:readSee productsOrgReadYesNo
products:updateChange, archive and restore productsOrgWriteYesNo
query:runAsk questions over your data (answers follow your read access)OrgReadYesNo
reports.schedules:createCreate report schedulesOrgWriteYesNo
reports.schedules:deleteDelete report schedulesOrgDeleteYesYes
reports.schedules:readSee report schedulesOrgReadYesNo
reports.schedules:updateChange report schedulesOrgWriteYesNo
reports:deleteArchive and delete report runsOrgDeleteYesYes
reports:downloadDownload reportsOrgReadYesNo
reports:generateGenerate and regenerate reportsOrgWriteYesNo
reports:readSee reportsOrgReadYesNo
resources.connector:readSee connectors (env names only, never secrets)OrgReadYesNo
resources.connector:testTest connectors from the OutpostOrgExternalYesNo
resources.connector:updateChange connectorsOrgWriteYesNo
resources.lineage:updateLink and unlink resourcesOrgWriteYesNo
resources.vendor:request_documentsEmail vendors for documentsOrgExternalYesNo
resources:attachAttach resources to products and detach themOrgWriteYesNo
resources:createUpload specs and vendor SBOMsOrgWriteYesNo
resources:deleteDelete resourcesOrgDeleteYesYes
resources:readSee resources, lineage and SBOMsOrgReadYesNo
resources:updateChange, archive and restore resourcesOrgWriteYesNo
roles:createCreate custom rolesTenantAdminNoNo
roles:deleteDelete custom rolesTenantAdminNoNo
roles:readSee rolesTenantReadYesNo
roles:updateChange custom rolesTenantAdminNoNo
scanners:readSee scannersOrgReadYesNo
scanners:runRun scannersOrgWriteYesNo
scanners:updateConfigure scannersOrgWriteYesNo
scans:cancelCancel scansOrgWriteYesNo
scans:deleteDelete scansOrgDeleteYesYes
scans:readSee scansOrgReadYesNo
scans:runRun and retry scansOrgWriteYesNo
scans:updateChange scan priority and orderOrgWriteYesNo
security:readSee security settings, everyone's sessions and sign-in historyTenantReadYesNo
security:updateChange SSO, 2FA and session settingsTenantAdminNoNo
service_accounts:createCreate service accountsTenantAdminNoNo
service_accounts:deleteDelete service accountsTenantAdminNoNo
service_accounts:readSee service accountsTenantReadYesNo
service_accounts:updateChange service accounts and their keysTenantAdminNoNo
sessions:revokeRevoke someone else's sessionTenantAdminNoNo
settings:updateChange general settingsTenantAdminNoNo
tenant:deleteDelete the tenantTenantAdminNoNo
tests.settings:updateChange Tests Center settingsTenantAdminNoNo
tests:approveApprove, reject or send back testsOrgWriteYesNo
tests:createCreate testsOrgWriteYesNo
tests:deleteArchive and delete testsOrgDeleteYesYes
tests:readSee tests, runs and vectorsOrgReadYesNo
tests:runRun, pause, resume, cancel and retest testsOrgExternalYesNo
tests:updateChange test context and plans, submit themOrgWriteYesNo

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.

PermissionAdminSecAppSecDevApprViewAuditBillCI
ai.settings:readYesYesYesYes
ai.settings:updateYes
ai:useYesYesYesYes
api_keys:readYesYesYes
api_keys:revokeYes
audit:exportYesYes
audit:readYesYesYes
billing:readYesYesYes
billing:updateYesYes
break:readYesYesYesYesYesYes
discovery:cancelYesYesYes
discovery:readYesYesYesYesYesYes
discovery:runYesYesYes
findings.settings:updateYesYes
findings:accept_riskYesYesYesYes
findings:create_ticketYesYesYesYes
findings:deleteYesYes
findings:exportYesYesYesYes
findings:open_prYesYesYesYes
findings:readYesYesYesYesYesYesYesYes
findings:rotate_secretYesYes
findings:updateYesYesYesYes
fixes:createYesYesYesYes
fixes:deleteYesYes
fixes:readYesYesYesYesYesYes
groups.members:updateYes
groups:createYes
groups:deleteYes
groups:readYesYesYes
groups:updateYes
guard.deployments:readYesYesYesYesYesYes
guard.events:readYesYesYesYesYesYesYes
guard.exceptions:approveYesYesYes
guard.exceptions:createYesYesYes
guard.exceptions:readYesYesYesYesYesYesYes
guard.exceptions:updateYesYesYes
guard.policies:createYesYesYes
guard.policies:deleteYesYes
guard.policies:enforceYesYesYes
guard.policies:exportYesYesYes
guard.policies:importYesYesYes
guard.policies:readYesYesYesYesYesYesYesYes
guard.policies:updateYesYesYes
guard.settings:updateYesYes
guard.tokens:createYesYes
integrations.routing:updateYesYes
integrations:createYesYes
integrations:deleteYesYes
integrations:readYesYesYesYesYesYes
integrations:syncYesYesYes
integrations:testYesYesYes
integrations:updateYesYes
members:inviteYes
members:readYesYesYesYes
members:removeYes
members:updateYes
orgs:createYesYes
orgs:deleteYesYes
orgs:updateYesYes
products.versions:createYesYesYes
products.versions:readYesYesYesYesYesYes
products.versions:updateYesYesYes
products:createYesYesYes
products:deleteYesYes
products:readYesYesYesYesYesYes
products:updateYesYesYes
query:runYesYesYesYes
reports.schedules:createYesYesYes
reports.schedules:deleteYesYesYes
reports.schedules:readYesYesYesYesYesYes
reports.schedules:updateYesYesYes
reports:deleteYesYes
reports:downloadYesYesYesYesYesYesYes
reports:generateYesYesYes
reports:readYesYesYesYesYesYes
resources.connector:readYesYesYesYesYesYes
resources.connector:testYesYesYes
resources.connector:updateYesYesYes
resources.lineage:updateYesYesYes
resources.vendor:request_documentsYesYesYes
resources:attachYesYesYes
resources:createYesYesYesYes
resources:deleteYesYes
resources:readYesYesYesYesYesYesYes
resources:updateYesYesYes
roles:createYes
roles:deleteYes
roles:readYesYesYes
roles:updateYes
scanners:readYesYesYesYesYesYes
scanners:runYesYesYes
scanners:updateYesYes
scans:cancelYesYesYes
scans:deleteYesYes
scans:readYesYesYesYesYesYesYes
scans:runYesYesYesYesYes
scans:updateYesYesYes
security:readYesYes
security:updateYes
service_accounts:createYes
service_accounts:deleteYes
service_accounts:readYesYesYes
service_accounts:updateYes
sessions:revokeYes
settings:updateYes
tenant:deleteYes
tests.settings:updateYesYes
tests:approveYesYesYes
tests:createYesYesYes
tests:deleteYesYes
tests:readYesYesYesYesYesYesYes
tests:runYesYesYes
tests:updateYesYesYes

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.