Skip to main content
Who can use this feature?
Organization Owners, Admins, and other users with the roles:manage permission
Custom resource roles let you gain more control over the permissions users have to manage individual Applications, Integrations, Workflows, and Scheduled Jobs. For example, you can create custom roles like:
Custom roleDescriptionResourcePermissions
QALets the QA team review application changes using commit previews, but doesn’t give them access to the live app.Applicationapps:preview
MaintainerGrants permissions to edit an integration’s credentials while not letting them delete or share the integrationIntegrationintegrations:update
integrations:build
ContributorCan make updates to assigned Workflows, but can’t deploy their changes.Workflowworkflows:update

​
Creating a custom role

To create a custom resource role:
  1. Click your avatar in the upper-left corner of the home page and click Organization Settings
  2. Click Roles & Permissions
  3. Click on the Resource roles tab
  4. Locate the resource you want to create a custom role for
  5. On the resource roles table, click + icon Create custom resource role
  6. Type a name and description for the custom role
  7. Click Create
  8. Add permissions to your custom role by selecting the permissions in the permission table
  9. Once you’ve selected all the permissions you want assigned to the role, click Save
After you create a custom role:

​
Editing a custom role’s details

To edit the name or description of a custom role:
  1. Click your avatar in the upper-left corner of the home page and click Organization Settings
  2. Click Roles & Permissions
  3. Click on the Resource roles tab
  4. Next to the role you want to edit, select the dropdown menu (⋯), then click Edit details
  5. Change the role as required, then click Save

​
Editing a role’s permissions

To edit the permissions associated with a custom role:
  1. Click your avatar in the upper-left corner of the home page and click Organization Settings
  2. Click Roles & Permissions
  3. Click on the Resource roles tab
  4. Locate the role you want to edit
  5. Check/uncheck the boxes associated with permissions you want to add/remove from the role
  6. Once you’ve made all your permission selections, click the Save button at the bottom of the page

​
Deleting a custom role

  1. Click your avatar in the upper-left corner of the home page and click Organization Settings
  2. Click Roles & Permissions
  3. Click on the Resource roles tab
  4. Next to the role you want to delete, select the dropdown menu (⋯), then click Delete
  5. In the confirmation dialog, choose a new role to assigned to users that currently are assigned the role being deleted, or select Remove access
  6. Click Reassign & delete

​
Precedence for different levels of access

Role and permissions are additive. If a person is given different levels of access through different avenues the user will have the sum of all access grants. For example, if the organization Owner assigns a user the End-user organization role, and then an app admin gives the user the Developer role on their Application, the user will be able to edit the application shard with them even though they cannot create their own Applications.