Overview
gentesty comes with these roles:
| Role | Technical name | For |
|---|---|---|
| Owner | owner | Whoever is responsible for the workspace. Can do everything, including adding payment methods and viewing invoices. |
| Workspace Administrator | workspace-admin | Whoever runs the workspace: bots and tests, plus users, API clients and the plan. No invoices, no single sign-on. |
| Bot Administrator | bot-admin | Whoever builds and operates bots and tests. In the Account area only their own profile. |
| Billing | billing | Whoever checks invoices, maintains the billing address and adds payment methods. |
| Viewer | viewer | Whoever 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.
| Task | Workspace Administrator | Bot Administrator |
|---|---|---|
| Create, change and delete chatbots, voicebots and test cases | Yes | Yes |
| Start, cancel and evaluate runs, export results | Yes | Yes |
| Manage LLM configurations, evaluators, tags and phone numbers | Yes | Yes |
| Manage notifications, webhooks, workflows and automations | Yes | Yes |
| Invite users, change roles, delete users, manage groups | Yes | No |
| See in the audit log who started or changed what | Yes | No |
| Set up single sign-on | No | No |
| Create API clients for the gentesty API | Yes | No |
| Change the billing address and request a plan change | Yes | No |
| See invoices and the cost of a run, add payment methods | No | No |
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.
| Area | Owner | Workspace Administrator | Bot Administrator | Billing | Viewer |
|---|---|---|---|---|---|
| Dashboard | View | View | View | View | View |
| Run Queue and results | Edit | Edit | Edit | – | View |
| Chatbots, voicebots and test cases | Edit | Edit | Edit | – | View |
| Phone Number | Edit | Edit | Edit | – | View |
| LLM Configs, Evaluators, Tags | Edit | Edit | Edit | – | View |
| Messaging: Notifications, Communications | Edit | Edit | Edit | – | View |
| Tasks: Webhooks, Workflows, Automations | Edit | Edit | Edit | – | View |
| Account › Account Settings: own name and password | Edit | Edit | Edit | Edit | Edit |
| Account › Payment Details: billing address | Edit | Edit | – | Edit | View |
| Account › Payment Details: change plan | Edit | Edit | – | – | View |
| Account › Payment Details: payment methods | Edit | – | – | Edit | – |
| Account › Billing: invoices | View | – | – | View | – |
| Account › User Management: users, groups, API | Edit | Edit | – | – | View |
| Account › User Management: single sign-on | Edit | View | – | – | View |
| Account › Audit Log | View | View | – | – | – |
| Cost of a run | View | – | – | – | – |
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.
| Role | Technical name | Can | Cannot |
|---|---|---|---|
| Bot Editor | bot-editor | Change 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 Runner | bot-runner | View bots, test cases and tags. Start and cancel runs, view results. | Change bots or test cases. |
| Case Administrator | case-admin | Create, change, delete and import test cases. View bots, evaluators, tags and results. | Start runs, change bots, create tags. |
| Case Editor | case-editor | Change 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
- Click Add User.
- Enter an address under User emails and press Enter. Repeat this for each person.
- Choose the Domain role. The list shows a short description of each role.
- 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
- Click the pencil icon in the person’s row.
- Choose the new role under Domain Role.
- Click Save.
- 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 see | Cause | Fix |
|---|---|---|
| Page No permission | Your 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 effect | The 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 list | The 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 page | Only 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.