> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/getting-started/users-and-roles.md).

# Users and roles

Add people to your organization, choose their role, give them access to projects, reset passwords and unlock accounts.

People work in Digital Studio as members of an **organization**. Their **organization role** decides which screens they can use; their **project role** decides what they can do in a particular project.

## Organization roles

| Role                                      | Who it is for                                                                                         |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Admin**                                 | Manages the organization: its users, and every project of the organization.                           |
| **User**                                  | Builds and maintains digital agents and analyses in the projects they are assigned to.                |
| **EndUser**                               | Business users who follow the results – statistics, recordings and data – without changing the flows. |
| **Service provider Admin** (`SuperAdmin`) | Born Digital staff who run the platform for all organizations.                                        |

What each role can use:

| Screen or action                                                                       | Service provider Admin |         Admin        |      User     |          EndUser         |
| -------------------------------------------------------------------------------------- | :--------------------: | :------------------: | :-----------: | :----------------------: |
| **Organization** › **Users**                                                           |            ✓           |           ✓          |       –       |             –            |
| **Organization** › **Settings** (default LLM provider and model)                       |            ✓           |           –          |       –       |             –            |
| **Data sources** › Connectors and Phone numbers                                        |            ✓           |           ✓          |       ✓       |             –            |
| **Data sources** › Input data, **Bubble design**                                       |            ✓           |           ✓          |       ✓       |             ✓            |
| Flow editor, Code editor, Training set, Regression test                                |            ✓           |           ✓          |       ✓       |             –            |
| Insights design and processing (data sources, parameters, prompts, categories, reruns) |            ✓           |           ✓          |       ✓       |             –            |
| Projects                                                                               |           all          |          all         | assigned only | assigned only, as Viewer |
| Create users                                                                           |        any role        | Admin, User, EndUser |       –       |             –            |

## Project roles

Open a project's details (single click in the project list, or the gear icon in the project sidebar) and go to the **Users** tab:

* **Owner** – full control of the project, including who else has access,
* **Editor** – can change the project, but cannot add or remove owners,
* **Viewer** – can open the project without changing it. **EndUser** members can only be viewers.

A project role counts only while the person is a member of the organization the project belongs to – as a regular member or as a guest. **EndUser** members can only view, whatever role is listed for them.

Admins of the organization the project belongs to have full access to it without being listed here. An Admin role in another organization gives no access to the project.

Realtime agents have their own **Users** tab with the same three roles – see [Realtime projects](https://docs.borndigital.ai/realtime-agent/projects.md#who-can-do-what).

## Manage users

Go to **Organization** › **Users** in the left sidebar. Only **Admins** (and Service provider Admins) see this page.

The table lists the members of each organization with their **Name**, **Surname**, **Email**, **Role**, **User status** and whether they are a **Guest**:

* **Active** – the user has set a password and can sign in,
* **Inactive** – the user has not activated the account yet,
* **Locked** – the account was locked after too many wrong passwords,
* **Guest** – the person's account belongs to another organization and was invited to this one.

Use **Search** on the right to find a user by name or e-mail.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-a778c35e12dfc1081aa8437143883cf3758c5da3%2Fgetting-started-users-table.png?alt=media" alt="The Users page with the New Organization, New User and Invite User buttons, the Search field, and the table grouped by organization with Name, Surname, Email, Role, User status and Guest"><figcaption><p>The Users page, filtered with Search</p></figcaption></figure>

### Add a new user

1. Click **New User**.
2. Fill in the **Name** and **Email**, choose the **Organization** and the **User role**.
3. Keep **Generate invitation email** ticked: the person receives an e-mail to create their own password (valid for 24 hours). Untick it only if you want to type a **Password** for them yourself.
4. **Allow data export from Kibana** lets the user export data from the analytics dashboards. It is ticked by default.
5. Click **Save**.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-b36b92c3ce85fa89aba0d446e2c7850bef0a1b89%2Fgetting-started-new-user.png?alt=media" alt="The New User dialog with Name, Email, Organization, User role, and the ticked options Allow data export from Kibana and Generate invitation email"><figcaption><p>The New User dialog</p></figcaption></figure>

### Invite an existing user

**Invite User** adds a person who already has a Digital Studio account in another organization to your current organization, as a **guest**. Enter their **Email**, choose the **Organization** and the **Role**, and click **Save**. No e-mail is sent – tell the person that they can now switch to your organization in the **Select organization** menu.

To remove a guest, click **Remove user from organization** in their row.

### Create an organization

**New Organization** creates a new organization from the one you are an Admin of – for example for a new department or a client.

1. Enter the **Organization name**. It must not be used by another organization.
2. Choose the **Source organization** – the organization the new one starts from.
3. Optionally turn on:
   * **Bulk invite user** – invite users of the source organization, **Based on role** or **Specific people**,
   * **Bulk import projects** – copy projects of the source organization,
   * **Bulk import input data tables** – copy its input data tables,
   * **Advanced settings** – the **Maximum parallel calls allowed** in the new organization.
4. Click **Save**.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2Fgit-blob-4ace542bd16d64a19a42eb645a21a22cde20b7fe%2Fgetting-started-new-organization.png?alt=media" alt="The New Organization dialog with Organization name, Source organization, and the switches Bulk invite user, Bulk import projects, Bulk import input data tables and Advanced settings"><figcaption><p>The New Organization dialog</p></figcaption></figure>

### Manage a user

Open the **⋮** menu in the user's row:

* **Change role** – choose the new role. You cannot give a role higher than your own. The user is signed out and gets the new role at the next sign-in. Changing a user to **EndUser** turns their **Owner** and **Editor** assignments in the organization – projects and realtime agents – into **Viewer**.
* **Reset password** – type a new password for the user, or tick **Generate password email** to send them a link to create one.
* **Unlock account** – shown instead of **Reset password** when the account is **Locked**. It unlocks the account and sets a new password in the same way.
* **Delete Account** – removes the user from Digital Studio. Confirm with **Delete**.

You cannot change your own account here. To reset someone's two-factor authentication, contact Born Digital support.

{% hint style="info" %}
If your organization signs in through single sign-on, users are managed in your company's identity system and **New Organization**, **New User** and **Invite User** are not shown.
{% endhint %}
