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

# forest users:edit

> Change a user's role, teams or permission level

# forest users:edit

Edit the role, teams or permission level of a user of a project. Pass at least one of `--role`, `--team` or `--permission-level`.

## Usage

```bash theme={null}
forest users:edit --email <EMAIL> [options]
```

## Options

| Option | Description |
| - | - |
| `-e, --email` | Email of the user to edit (required) |
| `-r, --role` | Name of the new role |
| `-t, --team` | Name of a team. Repeat the option for several teams. The list replaces the user's current teams on the project |
| `-l, --permission-level` | New permission level: `admin`, `developer`, `editor`, `manager` or `user` |
| `-p, --projectId` | The ID of the project to work on |
| `-f, --force` | Skip the confirmation asked when the change removes the user from a team |

## Examples

```bash theme={null}
# Change a user's role
forest users:edit --email jane@example.com --role Compliance

# Put a user in two teams, removing the others
forest users:edit -e jane@example.com -t Operations -t Support

# Promote a user to admin
forest users:edit -e jane@example.com --permission-level admin
```


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