> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles

> The **Roles** tab on the ***Users*** page enables you to manage system roles and access roles on your Connect AI account.

A **Role** defines the user's privileges and permissions.

<Note>
  In Connect AI, privileges are administrative actions, while permissions are data and execution
  access.
</Note>

The following system roles are available:

* **Administrator** has full access to all Connect AI functions, including adding and managing users.
* **Connection Administrator** can create, edit, and delete connections and workspaces. They can also assign connection and workspace permissions, view users, query all connections, and view connection-related audit log events.
* **User Administrator** can create, invite, edit, and disable users, assign and revoke the **User Administrator** and **Query** roles, and view user-related audit events.
* **Query** users can authenticate to a connection with their own credentials, as long as the user and connection meet the following criteria:

  * An Administrator or Connection Administrator grants the user permission to use the connection.
  * An Administrator selects **Per-User Authentication**, rather than **Shared Authentication**, for the connection.

  The query user can also issue queries to connections they have access to through the [Data Explorer](/en/Data-Explorer) page and through [integration tools](/en/Integrations). This role also allows viewing personal query logs.

Every account must have at least one active Administrator.

See [Permissions and Access Control](/en/Permissions) for more information about the scope of these roles.

<Note>
  By default, all CData Connect Spreadsheets users have an Administrator role. They have full
  Select, Insert, Update, Delete, and Execute permissions.
</Note>

The **Roles** tab contains information about every role in Connect AI. Roles consist of predefined **system roles** and **access roles**:

* A **system role** (Administrator, Connection Administrator, User Administrator, or Query) defines what a user can do across the platform (managing connections, users, and running queries), and every user has exactly one.
* An **access role** is an optional, admin-defined set of data and workspace permissions assigned on top of the system role; access roles are additive, so a user can hold several.

<Frame>
  <img src="https://mintcdn.com/cdata/Pmt_k8MgNXTO-9nH/en/images/roles.png?fit=max&auto=format&n=Pmt_k8MgNXTO-9nH&q=85&s=9377a15247aee4ed51d7986d4554dac1" alt="Roles list" width="911" height="535" data-path="en/images/roles.png" />
</Frame>

It contains the following information:

* A row for every role in your account:
  * **Role** is the role name.
  * **Privileges & Permissions** is a short overview of the scope of the role.
  * Edit and delete icons for the role. System roles cannot be deleted.

## Add an Access Role

<Steps>
  <Step>
    In the **Roles** tab of the **Users** page, click **Add Role** to open the **Add Role** page.

    <Frame>
      <img src="https://mintcdn.com/cdata/ns2CnTsbUGKdK2cZ/en/images/add_role.png?fit=max&auto=format&n=ns2CnTsbUGKdK2cZ&q=85&s=3ccdca2e0a7d565510102786e4623ee0" alt="Add a Role" width="1158" height="676" data-path="en/images/add_role.png" />
    </Frame>
  </Step>

  <Step>Enter the **Role Name**.</Step>
  <Step>Enter a short description of the role that will appear on the **Roles** list.</Step>

  <Step>
    In the **Entities** tab, select the appropriate permissions for entities (data connections and
    workspaces) in your Connect AI instance. For more information about permissions, see
    [Permissions and Access Control](/en/Permissions).
  </Step>

  <Step>
    In the **Users** tab, click **Assign Users** to assign multiple users to the same access role.

    <Note>
      You can also add permissions to a user on an individual basis. These permissions are added to
      the role-based permissions.
    </Note>
  </Step>

  <Step>Select one or more users to assign to the role, and click **Confirm**.</Step>
  <Step>Click **Save Changes** to save the role.</Step>
</Steps>

## Edit a Role

You can modify any role or delete an access role at any time by clicking the edit or delete icons in the **Roles** list.

<Frame>
  <img src="https://mintcdn.com/cdata/ns2CnTsbUGKdK2cZ/en/images/edit_role.png?fit=max&auto=format&n=ns2CnTsbUGKdK2cZ&q=85&s=f77bf9a31fadef5c1ab1d3b732000a02" alt="Edit a Role" width="1346" height="622" data-path="en/images/edit_role.png" />
</Frame>

In the **Edit Role** page, you can do the following:

* Edit the **Role Name** and **Description** fields (access roles only).
* Edit the permissions for the role.
* Assign or delete the users assigned to the role.
* Delete the entire role (access roles only).
