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

> Manage Deployment Teams.

> [!NOTE]
>
> The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change between product contexts.

Manage Deployment-level Teams.

> [tab] Astro
>
> ## Usage
>
> This command includes four subcommands: `add`, `list`, `update`, and `remove`.
>
> ```sh wrap theme={null}
> astro deployment team add --deployment-id=<your-deployment-id> <team-id> --role --workspace-id
> astro deployment team list --deployment-id=<deployment-id> <team-id> --role --workspace-id
> astro deployment team update --deployment-id=<your-deployment-id> <team-id> --role --workspace-id
> astro deployment team remove --deployment-id=<your-deployment-id> <team-id> --role --workspace-id
> ```
>
> To find a Team ID using the Astro CLI, run `astro organization team list`.
>
> To find a Team ID in the Astro UI, click **Organization Settings** > **Access Management** > **Teams**. Search for your Team in the **Teams** table and copy its **ID**. The ID should look something like `clk17xqgm124q01hkrgilsr49`.
>
> ## Options
>
> | Option | Description | Possible Values |
> | - | - | - |
> | `--deployment-id` (*Required*) | The Deployment for the Team | Any valid Deployment ID |
> | `<team-id>` (*Required*) | The Team's ID | Any valid Team ID |
> | `--role` | The role for the team. | `DEPLOYMENT_ADMIN` or a custom role name. |
> | `--workspace-id` | The Workspace from which to remove the user | Any valid Workspace ID |
>
> ### Additional options for `list`
>
> | Option | Description | Possible Values |
> | - | - | - |
> | `--json` | Output the response as JSON. Shorthand for `--output json`. Mutually exclusive with `-o`/`--output`. | None |
> | `-o`,`--output` | Format the output. The default is `table`. | `table`, `json`, or `template` |
> | `--template` | Format the output using a Go template. Use with `--output template`. | Any valid Go template string |

> [tab] APC
>
> ## Usage
>
> This command includes four subcommands: `add`, `list`, `update`, and `remove`:
>
> ```sh wrap theme={null}
> astro deployment team add --deployment-id=<your-deployment-id> <team-id>
> astro deployment team list <deployment-id>
> astro deployment team update --deployment-id=<your-deployment-id> <team-id>
> astro deployment team remove --deployment-id=<your-deployment-id> <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 is `cl4iqjamcnmfgigl4852flfgulye`.
> * Run [`astro workspace team list`](https://astronomer.io/docs/cli/v1.46/astro-workspace-team-list) and copy the value in the `ID` column.
>
> ## Options
>
> | Option | Description | Possible Values |
> | - | - | - |
> | `--deployment-id` (*Required*) | The Deployment for the Team | Any valid Deployment ID |
> | `<team-id>` (*Required*) | The Team's ID | Any valid Team ID |
> | `--role` | The Team's role in the Deployment | Possible values are either `DEPLOYMENT_VIEWER`, `DEPLOYMENT_EDITOR`, or `DEPLOYMENT_ADMIN`. Default is `DEPLOYMENT_VIEWER` |
