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

<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`. |