> ## 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

Create a new team

## Usage

```bash theme={null}
vastai create team [OPTIONS]
```

## Options

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

<ParamField path="--transfer-credit" type="number" default="0">
  amount of personal credit to transfer to the new team
</ParamField>

## Description

Creates a new team under your account.

Unlike legacy teams, this command does NOT convert your personal account into a team.
Each team is created as a separate account, and you can be a member of multiple teams.

When you create a team:

* You become the team owner.
* The team starts as an independent account with its own billing, credits, and resources.
* Default roles (owner, manager, member) are automatically created.
* You can invite others, assign roles, and manage resources within the team.

Optional:
You can transfer a portion of your existing personal credits to the team by using
the `--transfer_credit` flag. Example:
vastai create-team `--team_name` myteam `--transfer_credit` 25

Notes:

* You cannot create a team from within another team account.

For more details, see:
[https://vast.ai/docs/teams-quickstart](https://vast.ai/docs/teams-quickstart)

## Examples

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

## 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`) |