Skip to main content
Who can use this feature?
Organization Owners, Admins, and other users with the roles:manage permission
You can granularly control user permissions with custom organization roles. Organization 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. For example, you can use custom roles to grant a set of users permission to manage self-hosting the Superblocks data plane, without granting permission to invite and manage org members. Or let users create Apps, Workflows, and Jobs without granting permission to add Integrations. Each custom roles includes a set of permissions. Permissions either let users: This guide walks through how to create and manage custom organization roles. To learn more about assigning roles see Using organization roles

​
Creating a custom role

Organizations can create up to 10 custom organization roles. To create an organization role:
  1. Click your avatar in the upper-left corner of the home page and click Organization Settings
  2. Click Roles & Permissions
  3. On the Organization roles tab, click + Add role
  4. Type a name and description for the custom role
  5. Click Create
  6. Add permissions to your custom role by selecting permissions in the permission table. For a full reference to assignable permissions see the Permissions reference
  7. Once you’ve selected all the permissions you want assigned to the role, click Save

​
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. Next to the role you want to edit, select the dropdown menu (⋯), then click Edit details
  4. 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. Check/uncheck the boxes associated with permissions you want to add/remove from the role. Alternatively, if you want to grant all permissions associated with a type of Superblocks resource, check the box at the top of the resource group.
  4. Once you’ve made all your permission selections, click the Save button at the bottom of the page
Manage permissions of custom organization role For a full reference of permissions and the access they grant, see Permissions reference

​
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. Next to the role you want to delete, select the dropdown menu (⋯), then click Delete
  4. In the confirmation dialog, choose a new role to assign to users who are currently assigned the role being deleted
  5. Click Reassign & delete