Users access platform areas and actions based on their roles, known as role-based access control (RBAC). Torq offers preset roles: viewer, operator, creator, contributor, and owner.

RBAC in Torq provides flexible access control via policies. Common access controls include permissions for reading, writing, secrets, integrations, events, workflows, etc.

For organizational management, Torq assigns users/groups to high-level roles corresponding to typical organizational roles.

RBAC settings are unique to each Torq workspace. This means a user's role is defined separately for each workspace they are a part of.

To manage users and roles, go to Settings > Users.

You can create custom roles for your workspace. Contact Torq support for details.

Manage users

Invite users

Only users with the Owner role can invite other users to a workspace.

You can invite users directly from the platform by sending individual invitations. There is no option to send bulk invites.

There are additional ways to add users:

Go to Settings > Users and click Invite.
Enter the email address of the user you want to invite.
Select a Torq role to assign the user to.

Delete users

Only users with the Owner role can delete other users from a workspace.

Go to Settings > Users.
Locate the user you want to remove.
Click the three-dot menu and select Delete.

Manage groups

Owners can create and manage user groups within each workspace. These groups can be populated dynamically via SSO claim mapping or built manually by selecting users already in the workspace.

Create group

Go to Settings > Users. In the left side navigation bar, click Groups.
Click on Create.
Give the group a unique and meaningful name and description.
Select a membership type:
- Dynamic: membership is automatically synced based on IdP and SSO configurations. This requires an IdP to be configured in SSO settings.
- Static: Members are added and removed manually.
Click Create.
Add group members, or Skip for now to create the group without members.

The group membership type cannot be changed after the group has been created.

Edit group

Hover over the group you want to edit by clicking on the three-dot menu and Edit details.
Edit the group name and/or description and save changes.

Add members

To add members to an existing group,

Hover over the group you want to add members to. Click on the three-dot menu and Manage members.
In the Group members, search for members in your workspace and add them to the group members list.
Click Save.

You can manage group members at any time.