Skip to main content

astro workspace team add


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.

Add a Team to your current Workspace and grant it a Workspace role.


astro workspace team add <options>

If you run the command with no options specified, the CLI lists Teams in your Organization and prompts you to select one. It then adds the Team to your cuurent Workspace with the Workspace Member role.

To add a Team to a specific Workspace, specify the Workspace using the --workspace-id flag. To find a Workspace ID, run astro workspace list.


OptionDescriptionValid Values
--team-idThe ID for the Team to add to a Workspace. Bypasses the selection prompt.Any valid Team ID. You can find available Team ID's by running astro organization team list.
-r, --roleThe Team's role in the Workspace.Possible values are WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR, or WORKSPACE_OWNER. Default is WORKSPACE_MEMBER.
--workspace-idThe ID for the Workspace where you want to add the Team.Any valid Workspace ID. Default is the current Workspace context you are working in.

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.