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

# Settings

> Learn how to manage your account settings, organization settings, and user permissions within Kosmoy Studio.

# Configuring Settings

Kosmoy Studio provides comprehensive settings to manage your account, organization, and users. This section explains how to access and use these settings.

## Accessing Settings

1. **Click on your Profile Icon:** Locate your profile icon in the top right corner of the Kosmoy Studio interface.
2. **Click "Settings":** In the dropdown menu, click the **"Settings"** button.

## Account Settings

The **Account Settings** section allows you to manage your personal account details, including password and security settings.

### Security

#### Changing Your Password

1. **Navigate to "Account Settings" and then "Security":**
2. **Enter Current Password:** Enter your current password in the designated field.
3. **Enter New Password:** Enter your desired new password. Ensure it meets the displayed complexity requirements.
4. **Confirm New Password:** Re-enter your new password for confirmation.
5. **Click "Save":** Save the changes. A toast notification will confirm that your password has been updated successfully.

**Note:** If you enter an incorrect current password or if the new password doesn't meet the requirements, an error message will be displayed in red near the relevant field.

#### Enabling Two-Factor Authentication (2FA)

Enhance your account security by enabling 2FA using an authenticator app:

1. **Navigate to "Account Settings" and then "Security":**
2. **Locate the 2FA Section:** Find the section for Two-Factor Authentication.
3. **Enable 2FA:** Click the button or toggle to enable 2FA.
4. **Choose Authentication Method:** Select either scanning a QR code or manually entering a code.
5. **Follow the On-Screen Instructions:**
   * **Scan QR Code:** Use your authenticator app (e.g., Google Authenticator, Authy, Microsoft Authenticator) to scan the displayed QR code.
   * **Manual Entry:** Enter the provided code into your authenticator app.
6. **Enter Verification Code:** Enter the code generated by your authenticator app into the Kosmoy Studio interface.
7. **Confirm:** Complete the 2FA setup.

**Note:** Recovery codes will be available in the future to regain access if you lose your authenticator app.

#### Disabling 2FA

1. **Navigate to "Account Settings" and then "Security":**
2. **Locate the 2FA Section:**
3. **Disable 2FA:** Click the button or toggle to disable 2FA.

## Organization Settings (Root and Admin Users Only)

The **Organization Settings** section is only accessible to **Root** and **Admin** users. It allows you to manage organization-level settings and users.

**Note:** A visual indicator will be added in the future to clearly show that this section is restricted to Root and Admin users.

### General

The **General** subsection displays information about your organization (tenant):

* **Organization ID:**  A unique identifier for your organization.
* **Organization Name:** The name of your organization. (Cannot be edited after tenant creation).
* **Owner Account:** The email address of the Root User (tenant owner).

**Tenant Deletion:**

To delete your tenant, please contact support at [support@kosmoy.com](mailto:support@kosmoy.com).

### Users Directory

The **Users Directory** section contains the **Users** subsection, where you can manage users within your organization.

#### Users

The **Users** subsection allows you to view and manage all users within your tenant.

##### User Cards

Each user is represented by a card that displays:

* **Full Name:** The user's full name.
* **Description:** The user's role or any other relevant information.

##### Inviting Users

* **Root Users:** Can invite **Admin**, **Studio Developer**, and **Chat** users.
* **Admin Users:** Can invite **Studio Developer** and **Chat** users.

To invite a new user:

1. **Click the "Invite User" button:**
2. **Enter Email Address:** Provide the email address of the user you want to invite.
3. **Select Role:** Choose the appropriate role from the dropdown menu.
4. **Send Invitation:** Click the button to send the invitation email.

##### Editing User Properties

**Root** and **Admin** users can edit certain properties of existing users.

1. **Locate the User Card:** Find the card for the user you want to edit.
2. **Click the Edit (Pencil) Icon:**
3. **Modify User Properties:** You can update the user's **name** and **role**.
   * **Note:** Admin users can only promote a Chat User to a Studio Developer or demote a Studio Developer to a Chat User.
4. **Save Changes:** Click the "Save" button to apply the changes.

##### Deleting Users

**Root** and **Admin** users can delete other users from the tenant.

**Warning:** Deleting a user is a permanent action. While the user's data will be removed, associated data will be kept for compliance purposes.

1. **Locate the User Card:** Find the card for the user you want to delete.
2. **Click the Delete (Trash Bin) Icon:**
3. **Confirm Deletion:** Confirm that you want to delete the user.

**Note:** Users cannot delete themselves.

This section provides a comprehensive guide to managing settings within Kosmoy Studio.