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


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