> ## 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 roles:create

> Create a role in a Forest project

# forest roles:create

Create a new role in a project. Then set its permissions in the UI, with [`forest roles:apply`](https://docs.forest.app/reference/cli/roles-apply), or by copying them from another environment with [`forest roles:copy`](https://docs.forest.app/reference/cli/roles-copy).

## Usage

```bash theme={null}
forest roles:create --name <NAME> [options]
```

## Options

| Option | Description |
| - | - |
| `-n, --name` | Name of the role to create (required) |
| `-p, --projectId` | The ID of the project to work on |

## Examples

```bash theme={null}
# Create a role
forest roles:create --name "Support agent"

# Create a role in a specific project
forest roles:create -n Compliance -p 42
```


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