Guides Users and roles

Roles and permissions

Everyone in your workspace has a role. The role decides which pages a person can open and what they can change there.

For
Owners and workspace administrators
Time needed
About 5 minutes
Plan
Assigning roles from Business

Overview

gentesty comes with these roles:

RoleTechnical nameFor
OwnerownerWhoever is responsible for the workspace. Can do everything, including adding payment methods and viewing invoices.
Workspace Administratorworkspace-adminWhoever runs the workspace: bots and tests, plus users, API clients and the plan. No invoices, no single sign-on.
Bot Administratorbot-adminWhoever builds and operates bots and tests. In the Account area only their own profile.
BillingbillingWhoever checks invoices, maintains the billing address and adds payment methods.
ViewerviewerWhoever should see bots, test cases and results without changing anything.

The Group column of the user list shows the technical name. Four further roles cover single tasks, see Roles for single tasks.

If someone opens a page their role does not allow, they see No permission. Buttons for actions without permission are greyed out and show You don’t have permission for this action. when you hover over them.

Workspace Administrator or Bot Administrator?

Both roles can do everything around bots and tests: create, change and delete bots and test cases, start runs and evaluate the results. The difference is the Account area. There, the workspace administrator manages who has access to gentesty. The bot administrator only changes their own profile there.

TaskWorkspace AdministratorBot Administrator
Create, change and delete chatbots, voicebots and test casesYesYes
Start, cancel and evaluate runs, export resultsYesYes
Manage LLM configurations, evaluators, tags and phone numbersYesYes
Manage notifications, webhooks, workflows and automationsYesYes
Invite users, change roles, delete users, manage groupsYesNo
See in the audit log who started or changed whatYesNo
Set up single sign-onNoNo
Create API clients for the gentesty APIYesNo
Change the billing address and request a plan changeYesNo
See invoices and the cost of a run, add payment methodsNoNo

Give the Bot Administrator role to everyone who looks after bots and tests. Only the people who also manage users and access get the Workspace Administrator role.

What each role can do

The areas match the navigation on the left of the dashboard.

AreaOwnerWorkspace AdministratorBot AdministratorBillingViewer
DashboardViewViewViewViewView
Run Queue and resultsEditEditEdit–View
Chatbots, voicebots and test casesEditEditEdit–View
Phone NumberEditEditEdit–View
LLM Configs, Evaluators, TagsEditEditEdit–View
Messaging: Notifications, CommunicationsEditEditEdit–View
Tasks: Webhooks, Workflows, AutomationsEditEditEdit–View
Account › Account Settings: own name and passwordEditEditEditEditEdit
Account › Payment Details: billing addressEditEdit–EditView
Account › Payment Details: change planEditEdit––View
Account › Payment Details: payment methodsEdit––Edit–
Account › Billing: invoicesView––View–
Account › User Management: users, groups, APIEditEdit––View
Account › User Management: single sign-onEditView––View
Account › Audit LogViewView–––
Cost of a runView––––

Edit covers creating, changing and deleting. In the Run Queue it means starting and cancelling runs. View includes exporting, so a viewer can download test cases and results as an Excel file.

Which functions an area offers also depends on the plan. User management comes with Business, single sign-on and the API with the Enterprise plan.

Roles for single tasks

These roles give exactly the access a task needs. In the Account area they only change their own profile.

RoleTechnical nameCanCannot
Bot Editorbot-editorChange the settings of existing chatbots. View voicebots, test cases, tags and workflows. Start and cancel runs, view results.Create or delete bots or test cases, change test cases or voicebots.
Bot Runnerbot-runnerView bots, test cases and tags. Start and cancel runs, view results.Change bots or test cases.
Case Administratorcase-adminCreate, change, delete and import test cases. View bots, evaluators, tags and results.Start runs, change bots, create tags.
Case Editorcase-editorChange existing test cases. View bots, tags and results.Create or delete test cases, link further evaluators, start runs.

Anyone who creates bots, or writes test cases and also starts them, needs the Bot Administrator role.

If no role fits, create a group with its own permissions under Account › User Management › Groups with Add Group. A person in several groups gets the permissions of all of them.

Assign a role

gentesty Account › User Management › Users

Owners and workspace administrators assign roles. You can only choose roles whose permissions you have yourself; the others are greyed out.

Invite a new person

  1. Click Add User.
  2. Enter an address under User emails and press Enter. Repeat this for each person.
  3. Choose the Domain role. The list shows a short description of each role.
  4. Click Send invites.

Everyone in one invitation gets the same role. Invite people with different roles one after the other.

Change a person’s role

  1. Click the pencil icon in the person’s row.
  2. Choose the new role under Domain Role.
  3. Click Save.
  4. Ask the person to sign out and back in. Only then does the new role apply.

If your team signs in through single sign-on, the role comes from the role mapping of your identity provider. Change the group membership there instead, see Sign in with Microsoft Entra ID.

Troubleshooting

What you seeCauseFix
Page No permissionYour role does not allow this page, for example User Management as bot administrator.Ask an owner or workspace administrator for a suitable role. See What each role can do.
Button greyed out, You don’t have permission for this action.Your role may view the page but not change it.Ask for a role with edit permission.
The new role has no effectThe person is still signed in with the old role.Sign out and back in.
Pencil icon greyed out, This user is managed by the upstream identity provider.The person signs in through single sign-on.Change the role through the groups in the identity provider.
Pencil icon greyed out, There must be at least one user with the role owner.The person is the only owner.Give a second person the owner role first.
Pencil icon greyed out, You cannot edit or delete users whose role has permissions you do not have yourself.The person has a role with more permissions than you, for example owner.Ask an owner.
Role greyed out in the listThe role has permissions you do not have yourself.Ask an owner to assign the role.
User management is not included in the current subscription.Your plan does not include user management.Change the plan under Account › Payment Details.
No Costs on a run’s pageOnly owners see the costs.Ask the owner for the costs. The Billing role also sees the invoices.

Stuck? Contact us with the person’s name and role.