Skip to content

Permission areas

Assign roles from Set up roles. This page is the catalogue behind those roles: every verb, every area, and which role receives which grant.

You do not hand out these strings in the Users form. Use them to compare two roles, to read an API 403, or to check that a group design matches least privilege.

When this page and the invite form disagree, trust the role list shown in the product for that organisation.

Verbs

Every grant in the current catalogue uses one of these verbs. There are no others.

VerbWritten asWhat it means
All*Every permission in the organisation. Held only by Organisation Administrator and Administrator.
Seearea.readOpen and use that area without changing its configuration. Lists, detail, search, and exports where the area has them.
Changearea.writeCreate, edit, delete, assign, configure, or acknowledge in that area.

A role that lists engineering.write can also see engineering; write does not hide read. A role that lists only engineering.read can see and cannot change.

Some areas appear only as .write in the catalogue (devices, alerts, networks, status, delivery). Seeing the fleet for those jobs comes from tenant.read and the other .read grants on the same role. The .write name is the one that turns on the action.

Organisation-privileged work (SSO configuration, closing the subscription, SSO password break-glass) stays on Organisation Administrator / Administrator. It is not a separate verb you can attach to Developer or Support Engineer.

Areas

AreaGrant namesWhat it coversSeeChange
Tenanttenant.read, tenant.writeMembership in the organisation and structural adminStay a member and use organisation contextOrganisation settings, users, groups, SSO. In practice this sits on * roles.
Developerdeveloper.read, developer.writeDeveloper-portal assetsView developer assetsManage developer-portal assets
Engineeringengineering.read, engineering.writeDevice classes, software / firmware, engineering configurationView classes and software stateChange classes, software, and related engineering settings
Operationsoperations.read, operations.writeMonitors, automation, operational configurationView monitors and ops statusConfigure monitors, automation, and related ops settings
Incidentincident.read, incident.writeIncidents, on-call, response actionsView incidents and timelinesAcknowledge, update, or operate incident workflows
Securitysecurity.read, security.writeSecurity activity and detectionsView activity and detectionsChange detection policy and security integrations
Customercustomer.readCustomer and site contextView customer-linked recordsNo .write in the catalogue; site roles change the site through devices, networks, and ops grants
Networknetwork.writeNetworks and site structure(with tenant / customer reads)Create or change networks inside scope
Devicesdevices.writeDevice operation(with tenant / engineering / customer reads)Device actions such as reboot or capture
Alertsalerts.writeAlerting(with ops / support reads)Acknowledge or tune alerts where the role allows
Logslogs.readLog search and inspectionSearch and read logsLog-source setup follows developer / engineering change, not a logs.write grant
Statusstatus.writeStatus page updates(with ops / support reads)Publish or maintain status updates
Deliverydelivery.writeDelivery missions(as granted by the role's reads)Plan and operate delivery missions
Diagnosticsdiagnostics.readDiagnostic reads used by engineering-style rolesRun or view diagnosticsCovered by other change grants on the same role

Plan entitlements still apply. A role can include security.read and still see nothing if security detections are off for the organisation.

OEM roles

These roles appear in vendor / OEM organisations.

RoleUsers, groups, SSOEngineeringOps configDevice actionsIncidentsSecurityLogs
Organisation AdministratorChange, plus SSO break-glass and billing ownershipChangeChangeChangeChangeChangeSee
AdministratorChange (not break-glass, not close/replace the subscription)ChangeChangeChangeChangeChangeSee
DeveloperNoChangeChangeChangeChangeNoSee
Support EngineerNoSeeSeeNoChangeNoNo
Infrastructure AdminNoSeeChangeNoSeeNoNo
Infrastructure OperatorNoSeeChangeNoSeeNoNo
Engineering ViewerNoSeeNoNoNoNoSee
Operations ViewerNoNoSeeNoSeeNoNo
Incident ViewerNoNoSeeNoSeeNoNo
Security AdminNoSeeSeeNoSeeChangeNo
Security AnalystNoSeeSeeNoSeeSeeNo
Security ViewerNoNoNoNoNoSeeNo

Infrastructure Admin and Infrastructure Operator currently share the same permission list. Keep both so shift operators are not labelled as the people who own monitoring design.

Support Engineer can acknowledge incidents and alerts and can update status. It cannot search logs and cannot run device actions. Stack Engineering Viewer if that support pod must search logs.

Security Viewer is security activity only. It does not include fleet, engineering, or ops context. Use Security Analyst when the person must investigate with that context.

Customer portal roles

These roles appear in customer / site portal organisations.

RoleSite structureDevice actionsOps configAlertsIncidentsLogs
Organisation AdministratorChangeChangeChangeChangeChangeSee
AdministratorChangeChangeChangeChangeChangeSee
Site AdminChangeChangeChangeChangeSeeNo
Site OperatorNoChangeSeeChangeSeeNo
Site ViewerNoNoNoNoNoNo
ViewerNoNoSeeNoSeeSee

Site Viewer is customer-context visibility. Viewer is the broader read-only role (dashboards, inventory, engineering state, ops, incidents, and logs) with no writes.

Legacy labels still resolve: Site Admin may appear historically as network admin, Site Operator as operator. Use the labels in the current invite form.

Grant list by role

Each role is listed with its grant names. * is every named grant in the catalogue. Organisation ownership is not a grant name; only Organisation Administrator has it.

Organisation Administrator (ORG_ADMIN)

*

Plus organisation ownership: billing, closing the account, and the SSO password break-glass path.

Administrator (ADMINISTRATOR)

*

Same named grants, without billing, closing the account, or the SSO password break-glass path.

Developer (DEVELOPER)

tenant.read, developer.read, engineering.read, engineering.write, operations.read, operations.write, incident.read, incident.write, customer.read, network.write, alerts.write, devices.write, diagnostics.read, status.write, delivery.write, logs.read

Support Engineer (OEM_SUPPORT)

tenant.read, engineering.read, operations.read, incident.read, incident.write, customer.read, alerts.write, status.write

Security Admin (SECURITY_ADMIN)

tenant.read, engineering.read, operations.read, incident.read, security.read, security.write, customer.read

Security Analyst (SECURITY_ANALYST)

tenant.read, engineering.read, operations.read, incident.read, customer.read, security.read

Security Viewer (SECURITY_VIEWER)

security.read

Infrastructure Admin (INFRA_ADMIN)

tenant.read, engineering.read, operations.read, operations.write, incident.read, customer.read, status.write

Infrastructure Operator (INFRA_OPERATOR)

Same grants as Infrastructure Admin.

Engineering Viewer (ENGINEERING_VIEWER)

developer.read, engineering.read, logs.read

Operations Viewer (OPS_VIEWER)

operations.read, incident.read

Incident Viewer (INCIDENT_VIEWER)

incident.read, operations.read

Site Admin (NETWORK_OPERATOR)

tenant.read, engineering.read, customer.read, network.write, devices.write, alerts.write, operations.read, operations.write, incident.read

Site Operator (SITE_OPERATOR)

tenant.read, engineering.read, customer.read, devices.write, alerts.write, operations.read, incident.read

Site Viewer (SITE_VIEWER)

customer.read

Viewer (VIEWER)

tenant.read, customer.read, developer.read, engineering.read, operations.read, incident.read, logs.read

Where grants show up

PlaceWhat you see
NavigationSections missing when the person has no see grant (and the plan feature is on)
Page actionsCreate, edit, assign, or delete hidden or rejected when they can see but not change
Users and SSOReserved for Organisation Administrator and Administrator as the primary role
API and automationSame grants as the UI. A 403 is usually role, scope, or feature access
AuditActions are attributed to the signed-in user. Shared logins make this useless

Effective access is the union of the primary role and every group role. Scope tags then restrict which devices and networks that union applies to.