> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/coherent-control/user-management/user-permissions.md).

# User Permissions

This guide explains how to manage users on the Coherent platform. It covers creating users, first-time sign-in, and assigning roles and teams to individual users.

Administrator access is required to manage users, teams, and permissions. If you do not have administrator access and need changes, contact your tenant administrator.

### Permissions overview

The **Permissions** section is where administrators manage who can do what.

It has two pages:

* **User Permissions** — assign roles and teams to individual users.
* **Team Permissions** — create teams and assign shared roles to groups of users.

<figure><img src="/files/V1OvT9hTPcvp7IlPr4GH" alt=""><figcaption></figcaption></figure>

### Creating a user

New users are created from the **Orchestration** page, which lists every tenant you administer. Each row in the list represents one tenant. The **Manage Users** link opens that tenant's user list.

<figure><img src="/files/NZsL8Jd8d5fNCK4BaSJm" alt="Orchestration tenant list"><figcaption><p>Orchestration tenant list</p></figcaption></figure>

To add a user:

1. On the **Orchestration** page, click **Manage Users** next to the tenant you want to add the user to. The **Users** list for that tenant opens.
2. Click **Create User** in the top right.

<figure><img src="/files/bimx6sx6FbZoFovES5jM" alt="Users list with Create User button"><figcaption><p>Users list with Create User button</p></figcaption></figure>

3. Fill in the new user's **First Name**, **Last Name**, and **Email**, then click **Create**.

<figure><img src="/files/sfY6wsFMf0MLUmxcBaLD" alt="Create User dialog"><figcaption><p>Create User dialog</p></figcaption></figure>

The user is added to the tenant and an invitation email is sent to the address you provided.

### First-time sign in

When a new user is invited, they receive a welcome email titled *Welcome to Coherent Spark*. The email contains a **Complete your registration** button and a link to their workspace.

<figure><img src="/files/OV6PxhR7NdP6ORDnNBX8" alt="Welcome email"><figcaption><p>Welcome email</p></figcaption></figure>

To finish setting up the account:

1. Click **Complete your registration** in the email. This opens the account activation page.
2. Click **Click here to proceed**, then set a new password and click **Submit**.
3. Go to the workspace URL provided in the email and click **SIGN IN**.

<figure><img src="/files/DyKK2JqDd5XFToc44iiA" alt=""><figcaption></figcaption></figure>

4. Enter your email and password. After signing in, you are taken to the Dashboard.

<figure><img src="/files/XznQ5x9EWpXHx4mLCy21" alt=""><figcaption></figcaption></figure>

Bookmark the workspace URL for future logins. If the invitation has expired, you can reset your password using the **Forgot password** link on the sign-in page.

### Managing user permissions

The **User Permissions** page lists every user in the tenant along with the teams and roles they belong to.

<figure><img src="/files/l4xF80CLfntNNVz1V5G1" alt=""><figcaption></figcaption></figure>

#### Editing a user's teams and roles

Click the edit icon next to a user to update their team and role assignments. On the edit screen, select the teams the user should belong to on the left and the roles they should have on the right, then click **Save**.

<figure><img src="/files/MU71orlQtB1KfqZ3TY1Q" alt=""><figcaption></figcaption></figure>

#### Viewing a user's teams

Click **View User Teams** on any user row to see every team that user belongs to, along with when each team was last modified.

<figure><img src="/files/3MG4OM9s7oqkcKerk5zy" alt=""><figcaption></figcaption></figure>

#### Viewing a user's roles

Click **View User Roles** to see every role assigned to the user, together with a short description of what each role allows.

<figure><img src="/files/yDsVuMBgukrk7KZAevAt" alt=""><figcaption></figcaption></figure>

For team-wide access, see [Team Permissions](/coherent-control/user-management/team-permissions.md). For role requirements, see [Roles](/coherent-control/user-management/roles.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coherent.global/coherent-control/user-management/user-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
