Skip to main content

astro deployment team


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.


This command includes four subcommands: add, list, update, and remove.

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 Cloud UI, click your Workspace name in the upper left corner, then 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.


OptionDescriptionPossible Values
--deployment-id (Required)The Deployment for the TeamAny valid Deployment ID
<team-id> (Required)The Team's IDAny valid Team ID
--roleThe role for the team.DEPLOYMENT_ADMIN or a custom role name.
--workspace-idThe Workspace from which to remove the userAny valid Workspace ID

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.