Skip to content

Permissions and roles

Cloud Applications use role-based access control to manage who can view, modify, and operate cloud apps and their environments. Permissions are assigned via roles at the organisation level, giving you fine-grained control over what each team member can do.

Each permission controls access to a specific set of Cloud Application capabilities.

PermissionDescription
read_applicationsView cloud applications and their configuration
write_applicationsCreate and update cloud applications
delete_applicationsDelete cloud applications
read_environmentsView environments and their configuration
write_environmentsCreate and update environments
delete_environmentsDelete environments
trigger_syncTrigger a sync to non-production environments
trigger_prod_syncTrigger a sync to production environments
run_commandExecute commands in an environment
PermissionDescription
trigger_backupCreate a new backup of an environment
delete_backupDelete an existing backup
download_backupDownload a backup archive

Cloud Applications ship with five built-in roles that cover the most common team structures. Each role bundles the permissions listed above into a sensible default.

PermissionOrganization OwnerOrganization AdminCloud App ManagerCloud App DeveloperCloud App Read Only
read_applications
write_applications
delete_applications
read_environments
write_environments
delete_environments
trigger_sync
trigger_prod_sync
run_command
trigger_backup
delete_backup
download_backup
  • Organization Owner — Full access to all cloud application features
  • Organization Admin — Full access to all cloud application features
  • Cloud App Manager — Can create, update, and delete applications and environments, trigger syncs (including production), and manage backups
  • Cloud App Developer — Can view and update applications and environments, trigger non-production syncs, run commands, and create/download backups, but cannot delete applications, environments, or backups, or trigger production syncs
  • Cloud App Read Only — Can view applications, environments, and download backups, but cannot make any changes

Navigate to Team in the dashboard sidebar. Add team members and assign the appropriate role. Members inherit permissions from their role — there is no need to configure individual permissions manually.