Skip to content

Roles ​

You can review the permissions of each workspace role. You can also remove the guest invitation permission from the built-in Workspace Editor role, and create and manage custom roles by choosing permissions.

Built-in roles and custom roles ​

There are built-in roles and custom roles. Both are workspace roles, and each user or service account is assigned exactly one.

TypeDescription
Built-in roleWorkspace Owner, Workspace Editor, Workspace Viewer, and Workspace Guest. Their permissions are fixed, and you can't change or delete them. The exception is that you can remove guest invitations from Workspace Editor.
Custom roleA role you create for each workspace. You choose a level for each area in Permissions.

A custom role defines the default permissions across the whole workspace. Custom roles have no upper limit. When a user with a custom role is granted a resource role on a connection or teamspace, they can perform operations on that resource even if the custom role doesn't include them. Only the built-in Workspace Viewer and Workspace Guest roles act as an upper limit (Evaluation rules).

Custom roles are assigned and counted as follows:

  • You can assign them to users and service accounts. You can't assign them to guests.
  • Users with a custom role are members, not guests.
  • Permissions limited to Workspace Owners, such as deleting the workspace or granting the Owner role, can't be included in a custom role.

Viewing roles ​

Open the global nav > Workspace settings > Roles to see the list of roles. All members except Workspace Guests can view the list and the details of each role. Viewing roles is available in every workspace, regardless of your contract.

ColumnDescription
NameBuilt-in roles are marked Built-in.
DescriptionThe description of the role.
AssignedThe number of users and service accounts assigned the role. Pending invitations aren't included.
UpdatedWhen a custom role was last updated, and the member who updated it.

Select a row to open the role details, which show General (name and description) and Permissions. The Workspace Viewer details show the operations a viewer can't perform even when granted a resource role.

Changing guest invitations for Editor Optional feature ​

You can remove the Guest invitations permission from the built-in Workspace Editor role. When you remove it, Workspace Editors can no longer invite guests from reports.

TIP

This is an optional feature. Depending on your contract, it might not be available.

Only a Workspace Owner can change this setting.

  1. Open the global nav > Workspace settings > Roles, and select Editor.
  2. Under Permissions, turn the Guest invitations switch on or off.

The change works as follows:

  • The change applies to every user and service account with the Workspace Editor role.
  • Removing the permission doesn't affect guests who have already been invited.
  • Custom roles aren't affected. Whether a custom role can invite guests depends on Guest invitations in its permissions.
  • If this feature becomes unavailable because your contract changes, the removal stays in effect. You can only give guest invitations back to Workspace Editor.

Custom roles Beta Optional feature ​

A custom role is a workspace role that you build by choosing a permission level for each area. You can create roles with combinations of permissions that the built-in roles don't have, such as Editor permissions plus some management permissions, or view-only access to the areas you need.

INFO

This feature is in beta. The specification might change without notice.

TIP

This is an optional feature. Depending on your contract, it might not be available.

Creating a role ​

Only a Workspace Owner can create roles.

  1. Open the global nav > Workspace settings > Roles.
  2. From New role, choose a starting point.
    • Blank role: Every area starts at None.
    • Start from Editor: Starts with the same permissions as Workspace Editor.
  3. Enter a Name and Description.
    • The name must be unique among the roles in the workspace, ignoring case. You can't use built-in role names, such as Owner or Editor.
    • For the maximum length of the name and description, see Limits.
  4. Under Permissions, choose a level for each area.
  5. Select Create.

To start from an existing custom role, select Duplicate from the menu in its details. The creation screen opens with the permissions and description of the original role. The name is set to Copy of (role name).

You can't duplicate built-in roles. Workspace Owner has permissions that a custom role can't include, and Workspace Viewer has an upper limit.

Editing and deleting a role ​

Only a Workspace Owner can edit and delete roles. Other members see the role details as read-only.

  1. Open the global nav > Workspace settings > Roles, and select a custom role.
  2. In the role details, select Edit.
  3. Change the name, description, or permissions, and then select Save.

To delete a role, select Delete from the menu in the role details. Deletion can't be undone.

Editing and deleting work as follows:

  • Changes to permissions apply to every user and service account assigned the role as soon as you save.
  • You can't delete a role that's assigned. Assignments include pending invitations that specify the role. Change the role of those users and service accounts and delete the pending invitations first, and then delete the role.

Assigning a role ​

You choose a custom role on the same screens as a built-in role. Custom roles appear in the role options after the built-in roles.

Assigned toWhere to choose
UsersChanging a role on Users, and email invitations
Service accountsCreating or editing a service account

Assigning and changing roles requires the Members permission. For details, see Assigning custom roles.

Users who join through allowed domains or an invite link can't be assigned a custom role. Change their role after they join.

Permissions ​

Permissions in the role details shows the following items under each heading. For items you can choose, select None or one of the levels. A higher level includes the lower levels. For example, if you select Manage, the member can also perform the Create operations.

Items you can't choose show a fixed value:

  • Workspace owners only: Can't be granted to a custom role.

Workspace ​

ItemLevelDescription
Workspace settingsEditChange workspace settings, security, and AI settings. Workspace policies aren't included. For what's included, see Workspace permissions.
Audit logsViewView audit logs.
Contract managementWorkspace owners onlyDelete the workspace, and view the plan and subscription.

Members and groups ​

ItemLevelDescription
MembersManageInvite and remove users other than Workspace Owners, and change their roles. Also create, edit, and delete service accounts.
Guest invitationsInviteInvite people outside the workspace as guests from reports.
GroupsManageCreate groups and manage all groups.
Owner role and role definitionsWorkspace owners onlyGrant and revoke the Workspace Owner role, and create, edit, and delete roles.

A user with the Members permission can assign custom roles that have more permissions than their own. They can't grant or revoke the Workspace Owner role, or remove a Workspace Owner.

Guest invitations is required in addition to the report permissions (Report permissions). The Members permission alone doesn't let a user invite guests from reports. In the Workspace Editor details, Guest invitations appears as a switch (Changing guest invitations for Editor).

Connections ​

ItemLevelDescription
Workspace connectionsViewView connections whose access level is Workspace, and their schemas.
Workspace connectionsRunRun SQL on connections whose access level is Workspace.
Create and manage connectionsCreateAdd connections.
Create and manage connectionsManageUpdate, delete, and change permissions on every connection whose access level is Workspace or Protected, including ones created by others.

Workspace connections is the default access to connections whose access level is Workspace. When you grant a resource role on a connection, the member can also use that connection even if it isn't allowed here. To let a member use only some connections, select None for Workspace connections and grant a resource role on each connection they need (Connection permissions).

When you select Manage for Create and manage connections, the member can reach every connection whose access level is Workspace or Protected. For a Protected connection, they can grant themselves a resource role and access its data. Connections with the Private access level aren't included.

Notebooks ​

ItemLevelDescription
Workspace notebooksViewView notebooks whose access scope is Workspace.
Workspace notebooksEditCreate and edit notebooks whose access scope is Workspace.
Workspace notebooksPublishPublish notebooks whose access scope is Workspace as reports or links.
Private notebooksEditCreate and edit notebooks whose access scope is Private.
Private notebooksShare and publishShare Private notebooks with others and publish them.
Create and manage teamspacesCreateCreate teamspaces.
Create and manage teamspacesManageManage and change permissions on every teamspace, including ones created by others.

Notebooks shared with the member can be viewed and edited within the range granted by the sharing settings, regardless of the permissions chosen in the custom role.

When you select Manage for Create and manage teamspaces, the member can add themselves as a Teamspace Owner even to teamspaces they haven't been granted access to. Once added, they can also access the notebooks in that teamspace.

Workflows ​

ItemLevelDescription
WorkflowsCreateCreate workflows.
WorkflowsManageEdit, run, and delete every workflow, including ones created by others.

Others ​

ItemLevelDescription
Tag definitionsEditCreate, edit, and delete tag definitions.
External integrationsManageConnect Slack integrations, create agent connectors, and manage all external integrations.
API keysWorkspace owners onlyManage API keys.

When you select Manage for External integrations, the member acts as an admin of every Slack integration and agent connector. Even if they aren't included in an integration's admins and users, they can edit and delete it and change its admins and users. Managing includes using. To let members use an integration without managing it, grant access in each integration's admins and users.

Limits based on your contract ​

  • Viewing roles is available regardless of your contract. Changing guest invitations for Editor and custom roles might not be available, depending on your contract.
  • For the "Number of editors" limit (Limits), users with a custom role count in the same bucket as Workspace Owners and Editors, regardless of the permissions granted. This applies even to a custom role that only has view permissions. When the limit is reached, custom roles can't be selected.
  • If custom roles become unavailable because your contract changes, custom roles that are already assigned stay in effect. You can no longer create, edit, or delete roles, or newly assign a custom role.