CLI referenceastro workspace

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.

Usage

1astro 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 current 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.

Options

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_ACCESSOR, 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.