Skip to main content

Organization role permission reference

Organization-level roles control the Superblocks features members can access, the administrative actions they can perform, and the level of access users have to all current and future resources created in the org.

Governance

PermissionDescriptionMore info
access_tokens:manageAccess to create, view, update, and delete org-wide access tokens.Manage access tokens
access_tokens:readAccess to view org-wide access tokens. Can only view token metadata, not token values.Manage access tokens
agents:manageDeploy and manage On-Premise Agents used to execute organization code.About On-Premise Agent
agents:readView On-Premise Agents registered to execute organization code.About On-Premise Agent
folders:manageAccess to create, update, and delete folders users see on the Superblocks home page.
groups:manageAccess to create, view, update, and delete organization groups.Managing user groups
groups:readAccess to view organization groups.Managing user groups
groups.members:manageAccess to add and remove members from user groups.Manage group members
groups.members:readAccess to see which users are members of a group.Managing user groups
logs:readAccess logs for the organization. Logs many contain agent, profile, repository, or user information not otherwise accessible by viewer.About Logs
logs.streams:manageAccess to add, update, and remove Observability integrations used to stream logs to 3rd party monitoring platforms.Streaming Logs to Observability vendor
logs.streams:readAccess to view Observability integrations configured for the organization.Streaming Logs to Observability vendor
org:manageAccess to fully manage the organization, including the org's name, domains, plan, etc.
org:readRead-only access to organization settings like org name, domains, etc.
org.users:manageAccess to invite members to the organization, manage invites, and deactivate/reactivate member accounts.Managing members
org.users:readAccess to view who is a member of the organization.Managing members
profiles:manageAccess to create, view, update, and delete data profiles for the organization.About Profiles
profiles:readAccess to view the organization's data profiles.About Profiles
repos:manageAccess to create, view, update, and delete connection git repositories.Set up repositories
repos:readAccess to view connection git repositories.Set up repositories
roles:manageAccess to create, view, update, and delete custom organization and resource roles. This permission does not let users assign custom roles.Manage roles & permissions
roles:readAccess to view organization and resource roles.Manage roles & permissions
secrets_stores:manageAccess to create and manage organization secret stores.Using secret managers

Development

PermissionDescriptionMore info
apps:createAccess to create new ApplicationAbout Applications
integrations:createAccess to create new IntegrationsAbout Integrations
jobs:createAccess to create new Scheduled JobsAbout Scheduled Jobs
workflows:createAccess to create new WorkflowsAbout Workflows

Resource-level access

Custom organization roles can also be used to grant the following access to all current and future resources in the organization.

Applications

PermissionDescription
apps:updateEdit application, including creating branch and commits.
apps:deployDeploy a commit on the application's default branch to make it live for end-users.
apps:deleteDelete applications
apps:manage_visibilityMake applications publicly visible
apps:shareManage access to applications
apps:previewView branch & commit previews applications
apps:viewView live version of applications

Integrations

PermissionDescription
integrations:updateUpdate integration credentials/configurations
integrations:deleteDelete integrations
integrations:shareManage access to integrations
integrations:buildUse integrations in APIs

Scheduled Jobs

PermissionDescription
jobs:updateEdit Scheduled Jobs
jobs:deployDeploy job commits
jobs:deleteDelete Scheduled Jobs
jobs:shareManage development access to Scheduled Jobs
jobs:manage_scheduleManage cron schedule associated with Scheduled Jobs
jobs:runStart one time execution of Scheduled Jobs

Workflows

PermissionDescription
workflows:updateEdit Workflows
workflows:deployDeploy Workflow commits
workflows:deleteDelete Workflows
workflows:shareManage developer access to Workflows