# noust team

Manage teams, and the people in them.

```bash
noust team [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`add-member`](#noust-team-add-member), [`create`](#noust-team-create), [`delete`](#noust-team-delete), [`list`](#noust-team-list), [`members`](#noust-team-members), [`remove-member`](#noust-team-remove-member), [`rename`](#noust-team-rename)

## noust team add-member

Make an account a member of a team, or change its role there.

```bash
noust team add-member [OPTIONS] TEAM USERNAME
```

Arguments: `team`, `username`

| Option | What it does | Default |
|---|---|---|
| `--role` | The role in the team: viewer reads, operator also deploys, admin also changes, owner also governs the team. | `viewer` |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team create

Create a team, with a default project and its production environment.

```bash
noust team create [OPTIONS] NAME
```

Arguments: `name`

| Option | What it does | Default |
|---|---|---|
| `--slug` | Its short name; made from NAME when omitted. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team delete

Delete a team that holds nothing.

```bash
noust team delete [OPTIONS] TEAM
```

Arguments: `team`

| Option | What it does | Default |
|---|---|---|
| `--yes`, `-y` | Do not ask for confirmation. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team list

List the teams, with how many people and projects each has.

```bash
noust team list [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the teams as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team members

List a team's members and their role in it.

```bash
noust team members [OPTIONS] TEAM
```

Arguments: `team`

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the members as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team remove-member

Take an account out of a team.

```bash
noust team remove-member [OPTIONS] TEAM USERNAME
```

Arguments: `team`, `username`

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust team rename

Change the name a team is shown as; its slug stays.

```bash
noust team rename [OPTIONS] TEAM NAME
```

Arguments: `team`, `name`

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |