Skip to main content

astro deployment team


This command is available only if you're authenticated to an Astronomer Software installation.

Manage Deployment-level Teams on Astronomer Software.


This command includes four subcommands: add, create, delete, and list

astro deployment team add --deployment-id=<your-deployment-id> <team-id>
astro deployment team list <deployment-id>
astro deployment team --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 Software UI and copy the last part of the URL in your web browser. For example, if your Team is located at, your Team ID is cl4iqjamcnmfgigl4852flfgulye.
  • Run astro workspace team list and copy the value in the ID column.


OptionDescriptionPossible Values
--deployment-id (Required)The Deployment for the TeamAny valid Deployment ID
<team-id> (Required)The Team's IDAny valid Team ID
--roleThe Team's role in the DeploymentPossible values are either DEPLOYMENT_VIEWER, DEPLOYMENT_EDITOR, or DEPLOYMENT_ADMIN. Default is DEPLOYMENT_VIEWER

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.