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

<Info>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.</Info>

Manage Deployment-level Teams.

<Tabs>
  <Tab title="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                    |
  </Tab>

  <Tab title="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`](/docs/cli/v1.39/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` |
  </Tab>
</Tabs>