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
- Software
Usage
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.
Options
| Option | Description | Valid Values |
|---|---|---|
--team-id | The 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, --role | The 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-id | The 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. |
Manage Astronomer Software Teams.
Usage
If you want to add a team to the current Workspace with the default role of Workspace Member, you can run astro workspace team add <team-id>, with the team ID that you want to add.
astro workspace team add <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
BASEDOMAIN.astronomer.io/w/cx897fds98csdcsdafasdot8g7/team/cl4iqjamcnmfgigl4852flfgulye, your Team ID would becl4iqjamcnmfgigl4852flfgulye. - Run
astro organization team listand copy the value in the ID column
Options
| Option | Description | Possible Values |
|---|---|---|
<team-id> (Required) | The Team's ID | Any valid Team ID |
--role | The Team's role in the Workspace. | Possible values are WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR, or WORKSPACE_OWNER. Default is WORKSPACE_MEMBER. |