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

# vastai create team-role

Add a new role to your team

## Usage

```bash theme={null}
vastai create team-role --name NAME --permissions PERMISSIONS
```

## Options

<ParamField path="--name" type="string">
  name of the role
</ParamField>

<ParamField path="--permissions" type="string">
  file path for json encoded permissions, look in the docs for more information
</ParamField>

## Description

Creating a new team role involves understanding how permissions must be sent via json format.
You can find more information about permissions here: [https://vast.ai/docs/cli/roles-and-permissions](https://vast.ai/docs/cli/roles-and-permissions)

## Examples

```bash theme={null}
vastai create team-role
```

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |