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

# vesslctl org & team

> Manage organizations and teams for access control and resource scoping.

VESSL Cloud uses a two-level hierarchy for access control: **organizations** contain **teams**. Most commands operate within the context of your currently selected org and team.

## Organization commands

### org list

List all organizations you belong to.

```bash theme={null}
vesslctl org list
```

### org show

Display details about an organization. Defaults to the current org if no name is provided.

```bash theme={null}
vesslctl org show [name]
```

| Argument | Description                                       |
| -------- | ------------------------------------------------- |
| `name`   | Organization name (optional, defaults to current) |

### org switch

Switch your default organization context. Subsequent commands will operate under this org.

```bash theme={null}
vesslctl org switch <name>
```

| Argument | Description                    |
| -------- | ------------------------------ |
| `name`   | Organization name to switch to |

**Example:**

```bash theme={null}
vesslctl org switch vessl-ai
```

### org create

Create a new organization.

```bash theme={null}
vesslctl org create --name <name>
```

| Flag     | Required | Description       |
| -------- | -------- | ----------------- |
| `--name` | Yes      | Organization name |

**Example:**

```bash theme={null}
vesslctl org create --name my-org
```

<Note>
  The `organization` alias can be used interchangeably with `org` (for example, `vesslctl organization list`).
</Note>

## Team commands

### team list

List all teams in your current organization.

```bash theme={null}
vesslctl team list
```

### team show

Display details about a team. Defaults to the current team if no name is provided.

```bash theme={null}
vesslctl team show [name]
```

| Argument | Description                               |
| -------- | ----------------------------------------- |
| `name`   | Team name (optional, defaults to current) |

### team switch

Switch your default team context.

```bash theme={null}
vesslctl team switch <name>
```

| Argument | Description            |
| -------- | ---------------------- |
| `name`   | Team name to switch to |

**Example:**

```bash theme={null}
vesslctl team switch ml-research
```

### team create

Create a new team in your current organization.

```bash theme={null}
vesslctl team create --name <name>
```

| Flag            | Required | Description      |
| --------------- | -------- | ---------------- |
| `--name`        | Yes      | Team name        |
| `--description` | No       | Team description |

**Example:**

```bash theme={null}
vesslctl team create --name ml-research --description "Machine learning research team"
```