> For the complete documentation index, see [llms.txt](https://docs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akinon.com/tutorials/app-maker/team-and-access/users-and-roles.md).

# Users & Roles

## 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.

**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.

**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.

**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.

#### 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.
* The **Edit** (and delete) actions are only available to the organization owner. If you don't manage the organization, the actions column is hidden and these icons won't appear.

**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.

**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.

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

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

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

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

**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.

**Step 4: Send Changes​**

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


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.akinon.com/tutorials/app-maker/team-and-access/users-and-roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
