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

# astro team

> Reference documentation for astro team.

<Info>This command is available only if you're authenticated to an Astro Private Cloud installation.</Info>

Manage system-level Teams on Astro Private Cloud. See [Import identity provider groups into Astro Private Cloud](https://www.astronomer.io/docs/software/import-idp-groups).

## Usage

This command has several subcommands. Read the following sections to learn how to use each subcommand.

### astro team get

View information for a single Team.

#### Usage

```sh wrap theme={null}
astro team get <team-id>
```

You can retrieve a Team's ID in one of two ways:

* Access the Team in the UI and copy the last part of the URL in your web browser. For example, if your Team is located at `BASEDOMAIN.astronomer.io/w/cx897fds98csdcsdafasdot8g7/team/cl4iqjamcnmfgigl4852flfgulye`, your Team ID would be `cl4iqjamcnmfgigl4852flfgulye`.
* Run [`astro team list`](#astro-team-list) and copy the value in the `ID` column.

#### Options

| Option | Description | Possible Values |
| - | - | - |
| `-a`, `--all` | View all information about the Team | None |
| `-r`, `--roles` | View role details for the Team | None |
| `-u`, `--users` | View all users in the Team | None |

### astro team list

List all Teams on Astro Private Cloud.

#### Usage

```sh wrap theme={null}
astro team list
```

#### Options

| Option | Description | Possible Values |
| - | - | - |
| `-a`, `--all` | View all information about the Team | None |
| `-p` `--paginated ` | Paginate the list of Teams. If `--page-size` is not specified, the default page size is 20. | None |
| `-s` `--page-size` | The page size for paginated lists. | Any integer |

### astro team update

Update an Astro Team's system-level role.

#### Usage

```sh wrap theme={null}
astro team update <team-id> --role=<system-role>
```

You can retrieve a Team's ID in one of two ways:

* Access the Team in the UI and copy the last part of the URL in your web browser. For example, if your Team is located at `BASEDOMAIN.astronomer.io/w/cx897fds98csdcsdafasdot8g7/team/cl4iqjamcnmfgigl4852flfgulye`, your Team ID is `cl4iqjamcnmfgigl4852flfgulye`.
* Run [`astro team list`](#astro-team-list) and copy the value in the `ID` column.

#### Options

| Option | Description | Possible Values |
| - | - | - |
| `-r` `--role` | The Team's system-level role | Possible values are `SYSTEM_VIEWER`, `SYSTEM_EDITOR`, or `SYSTEM_ADMIN`. |