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

# Configuring your account

> Manage users, environments, and API keys in Oso Cloud Pro or Enterprise.

## User management

### Add users to your organization

**Prerequisites:**

* The person you want to invite must already have an Oso Cloud Developer account (GitHub or Google sign-in).
* Collect their GitHub username or Google Workspace email to add them.

**Steps:**

**Step 1**

Go to the [Users tab](https://ui.osohq.com/settings/?tab=users) in settings

**Step 2**

Click **Add a user**

**Step 3**

Enter the user's GitHub username or Google Workspace email

**Step 4**

Click **Add user**

> [!WARNING]
>
> Only existing Oso Cloud users can be added. The system returns an error for unknown usernames.

### Configure user roles

Oso Cloud supports two user roles:

**Member**

* Read access to all organization environments.
* Manage non-production environments.

**Admin**

* All Member permissions.
* Manage production environments.
* Invite/remove users.
* Change user roles.

#### Change a user's role

New users default to Member role.

**Step 1**

Navigate to the [Users tab](https://ui.osohq.com/settings/?tab=users)

**Step 2**

Click the Role dropdown next to the user

**Step 3**

Select the new role

### Remove users

Remove users who leave your company or change teams:

**Step 1**

Go to the [Users tab](https://ui.osohq.com/settings/?tab=users)

**Step 2**

Click **Remove** next to the user

**Step 3**

Confirm removal in the modal dialog

## Environment management

### Create new environments

Oso Cloud provides default environments, but you can create additional ones for specific use cases:

**Step 1**

Navigate to the [Environments tab](https://ui.osohq.com/settings/?tab=environments)

**Step 2**

Click **Create**

**Step 3**

Enter the environment name

**Step 4**

Click **Create**

### Delete environments

Delete environments you no longer need:

**Step 1**

Go to the [Environments tab](https://ui.osohq.com/settings/?tab=environments)

**Step 2**

Click **Delete** next to the target environment

**Step 3**

Type the environment name to confirm

**Step 4**

Click **Confirm**

> [!NOTE]
>
> **Note:** Default environments cannot be deleted.

## API key management

### Create API keys

Create API keys for programmatic access to Oso Cloud:

**Step 1**

Navigate to the [API Keys tab](https://ui.osohq.com/settings/?tab=api-keys)

**Step 2**

Click **Create API Key** next to your target environment

**Step 3**

Select key type:

* **Read-Write:** Full authorization operations
* **Read-Only:** Query-only access

**Step 4**

Copy the generated key immediately

**Key management options:**

* Use **Copy** to copy only the API key
* Use copy icons for environment variable commands

> [!WARNING]
>
> **Security Alert:** API keys display only once and cannot be retrieved later. Store them securely.

> [!WARNING]
>
> **Limit:** Maximum 128 tokens per environment.

### Revoke API keys

Revoke compromised or unused API keys:

**Step 1**

Go to the [API Keys tab](https://ui.osohq.com/settings/?tab=api-keys)

**Step 2**

Click **Revoke** next to the target key

**Step 3**

Enter the API key ID to confirm

**Step 4**

Click **Revoke API Key**

**Common revocation scenarios:**

* Compromised credentials
* Key rotation policies
* Cleanup of unused keys


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.