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

# Users & Roles

## Users in Your Organization

The **Users** section displays a list of all members within your organization. You can assign them roles with varying permissions based on their responsibilities.

This enables clear role-based access control for managing projects, agents, and settings.

## Roles and Responsibilities

There are **three types of user roles** in the organization, each with distinct levels of access and responsibility:

### 1. Owner of Organization

* Full access to all organizational settings, users, and permissions
* Can add, edit, delete, or activate/deactivate users
* Can invite users as **Admin** or **Owner**

### 2. Admin of Organization

* Can manage users, data, and organization settings
* May have limited access to owner-level features

### 3. User / Agent Manager

* Can access assigned projects and resources
* Cannot manage other users or modify organizational settings

***

## User Management Actions

<CardGroup cols={2}>
  <Card title="Add Users in Organization" icon="star" href="/oraganization-console/users#add-users-to-your-organization">
    Add and invite users to your organization and assign them roles.
  </Card>

  <Card title="User Console" icon="chart-simple" href="/oraganization-console/users#user-console">
    View and manage user details in the User Console.
  </Card>
</CardGroup>

***

## Add Users to Your Organization

To add a new user:

* Navigate to the **Users** section (1)
* Click on **Add User** (2)
* Fill out the following:
  * **Email address** (3)
  * **Role selection** (4)
  * **Assign to project(s)** (5)
* Click **Send Invitation** (6)

Once the invitation is accepted, the user will be successfully added.

<Frame caption="Users: View Existing Members">
  <img src="https://mintcdn.com/aptlytechnologies/PJxqOS6CrBAi41UF/images_new/orgconsole/adduser.png?fit=max&auto=format&n=PJxqOS6CrBAi41UF&q=85&s=a78ed48d72ab77df9c79d2f5a9dd6218" alt="Users list view" width="2000" height="1066" data-path="images_new/orgconsole/adduser.png" />
</Frame>

Below is the modal where you send the invite and define the user role:

<Frame caption="Users: Send Invitation Modal">
  <img src="https://mintcdn.com/aptlytechnologies/o4VizAsTx-jdBxlE/images_new/orgconsole/inviteusers.png?fit=max&auto=format&n=o4VizAsTx-jdBxlE&q=85&s=a6079c6a93e3252c720b775487911531" alt="Send invitation popup" width="2000" height="1066" data-path="images_new/orgconsole/inviteusers.png" />
</Frame>

## Bulk User Upload via CSV

In addition to adding users one by one, you can also **invite multiple users at once** using a **CSV or Excel file**.

This is useful for onboarding larger teams quickly — simply upload a file containing multiple email addresses.

<Frame caption="Users: Bulk Invite via CSV">
  <img src="https://mintcdn.com/aptlytechnologies/NlrTwqWOc-besmXO/images/orgconsole/multiusercsv.png?fit=max&auto=format&n=NlrTwqWOc-besmXO&q=85&s=8b0d0221ff07c8bf408b29ec43a3b47e" alt="Invite multiple users via CSV" width="2000" height="1066" data-path="images/orgconsole/multiusercsv.png" />
</Frame>

#### CSV Upload Requirements

* **Accepted formats:** `.csv`, `.xls`, `.xlsx`
* **Limit:** Up to **50 email addresses per upload**
* **File rule:** Each email address must appear on a **separate row**
* **Required columns:**
  * `fullname`
  * `username`
  * `email` *(ensure all emails are listed in this column)*

You can use the **Choose File** option in the “Invite User” modal to upload your CSV.\
Once uploaded, the system validates the file format and displays any errors if the structure doesn’t match the required fields.

> 💡 **Tip:** Double-check that the CSV includes the column headers exactly as shown (`fullname`, `username`, `email`) to ensure smooth import.

## User Console

The **User Console** provides a complete view of your profile and access details within the organization.\
Here, you can view and update your account information such as:

* **Full Name**
* **Email ID**
* **Role** (e.g., Owner, Admin, or User)
* **User ID**
* **Time Zone**
* **Account Creation Date**
* **Status** (Enabled/Disabled)

<Frame caption="User Console: Overview">
  <img src="https://mintcdn.com/aptlytechnologies/NlrTwqWOc-besmXO/images/orgconsole/userconsole.png?fit=max&auto=format&n=NlrTwqWOc-besmXO&q=85&s=31f39ff53249d64e51bdafd8592bc82d" alt="User Console overview page" width="2000" height="1066" data-path="images/orgconsole/userconsole.png" />
</Frame>

***

### Tabs in the User Console

The top navigation tabs allow you to explore different views:

* **All Users** – View a list of all members in the organization
* **Overview** – Manage your personal details and settings
* **AI Agents** – See agents created or managed by you
* **Teams** – Check which teams or projects you belong to
* **Login History** – Review all your login activities

This makes it easy to access teammate information, assigned projects, and your own workspace from one central view.

***

### Login History

The **Login History** tab displays detailed records of your login activity.\
It helps you track your access sessions and ensure account security.

<Frame caption="User Console: Login History">
  <img src="https://mintcdn.com/aptlytechnologies/NlrTwqWOc-besmXO/images/orgconsole/loginhistory.png?fit=max&auto=format&n=NlrTwqWOc-besmXO&q=85&s=61394c005c44986e5a8f80b697e4074c" alt="Login history tab view" width="2000" height="1066" data-path="images/orgconsole/loginhistory.png" />
</Frame>

#### Information Shown in Login History

* **Login Date & Time** – When you last accessed your account
* **Username** – The name used during login
* **IP Address** – The network location of your session
* **User Agent** – The browser or device used to log in
* **Login Status** – Whether the attempt was successful or failed

> 💡 Use this tab to review your recent sessions and identify any unfamiliar login attempts.
