# Users & Roles

## <mark style="color:red;">Users​</mark> <a href="#users" id="users"></a>

User settings on AppMaker are managed through the Users page. A user is specifically defined as an individual who logs into the platform.

Within this page, all users affiliated with the organization, along with their authorizations and authorization groups, can be easily viewed. By selecting the Users menu item, administrators can effortlessly add new users or edit existing ones.

The system's current users are listed in a user-friendly manner, with a summary table showcasing their general information for quick reference.

### Add User​ <a href="#add-user" id="add-user"></a>

**Step 1: Access the Users Screen​**

* Open App Maker and navigate to the **Settings > Users** tab.
* A list of existing users will be seen on the Users screen.

  <figure><img src="/files/72a4X4Mdyn3xGWqAE9WQ" alt=""><figcaption></figcaption></figure>

**Step 2: Add a New User​**

* To add a new user to the organization, click the **Add User** button on the list screen.
* When you enter the user's email, the user list will be displayed if the user has not been added to another organization.

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

**Step 3: Fill in User Details​**

* On the user creation page, provide all the necessary information, such as user and roles for the new user.
* Roles are assigned to users based on the authorization preferences.
* Notably, a single user can have multiple roles, granting them various permissions within the platform.

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

**Step 4: Role Privileges​**

* To get a comprehensive understanding of each role and its associated authorizations, consult the **Privileges** table.
* The table displays a breakdown of the actions authorized for pre-defined user and role types.

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

### Edit User​ <a href="#edit-user" id="edit-user"></a>

**Step 1: Find the User to Edit​**

* Look through the list of users to locate the specific user whose settings are desired to change.

**Step 2: Edit User​**

* At the end of the user's row, click on the **Edit** icon.

**Step 3: Modify Information​**

* A new screen will appear with the user's details.
* Update any necessary information.
* Adjust the user's roles as required.

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

**Step 4: Send Changes​**

* After making the desired changes, save the updates to apply the edited settings.

## <mark style="color:red;">Roles​</mark> <a href="#roles" id="roles"></a>

Roles are a specific set of authorization rules assigned to users. Within App Maker, there are predefined roles that users can utilize, and they also have the flexibility to create custom roles tailored to their preferences.

The Roles page provides an overview of all the roles added under users' organization, allowing them to manage and assign authorizations efficiently.

### Create Role​ <a href="#create-role" id="create-role"></a>

**Step 1: Access the Roles Screen​**

* Open AppMaker and navigate to the **Settings > Roles** section.
* A list of existing roles will be seen on the Roles screen.

  <figure><img src="/files/2a4xfOalJY28lJrmeMKg" alt=""><figcaption></figcaption></figure>

**Step 2: Create a New Role​**

* Click on the **ADD NEW ROLE** button to create a new role.

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

**Step 3: Fill in Role Details​**

* On the new role creation page, provide the required role information.

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

**Step 4: Assign Privileges​**

* Next, assign specific authorizations to the new role.
* In the **Privileges** list, choose the permissions want to grant to the role.

### Edit Role​ <a href="#edit-role" id="edit-role"></a>

**Step 1: Find the Role to Edit​**

* Look through the list of roles to locate the specific role whose settings are desired to change.

**Step 2: Edit Role​**

* At the end of the role's row, click on the **Edit** icon.

**Step 3: Modify Information​**

* A new screen will appear with the role's details.
* Update any necessary information, such as role name and privilege settings.

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

**Step 4: Send Changes​**

* After making the desired changes, remember to save the updates to apply the edited settings.


---

# Agent Instructions: 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.akinon.com/tutorials/app-maker/users-and-roles.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.
