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

# Users / roles

> Manage user accounts, roles, and access permissions across the entire system

The **Users** section allows you to manage user accounts, roles, and access within your workspace.

## List users

To view the list of users:

1. Navigate to **Users**
2. Browse the list to see user name, email, role, and status
3. Use the search bar to quickly find a specific user

## Create a new user

To create a new user:

1. Navigate to **Users**
2. Click the **Add** button
3. Enter the user name
4. Enter the email address
5. Enter a password
6. Select a role
7. Click **Create User**

The user will be able to sign in immediately after creation.

## View user details

To view detailed information of a user:

1. Navigate to **Users**
2. Click on a user in the list

You will see detailed information including user ID, name, email, role, status, and account metadata.

## Update user information

To update user information:

1. Open the user detail view
2. Click **Change** next to the field you want to update (name, email, password)
3. Enter the new value
4. Save the changes

## Change user role

To change a user's role:

1. Open the user detail view
2. In the **Change role** section
3. Select a new role from the dropdown

Changes take effect immediately.

## Ban a user

To ban a user:

1. Open the user detail view
2. In the **Danger zone** section
3. Click **Ban user**

## Delete a user

To delete a user:

1. Open the user detail view
2. In the **Danger zone** section
3. Click **Delete user**

<Danger>
  This action permanently removes the user from the system. All access is lost and this operation cannot be undone.
</Danger>