Skip to main content

astro workspace team update


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.

Update a Team's permissions in a given Workspace.


astro workspace team update <team-id> --workspace-id <workspace-id> --role=<system-role>

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
--workspace-idThe Workspace for the Team. Use to override CLI prompts.Any valid Workspace ID.
<team-id>The ID for the Team. Use to override CLI prompts.Any valid Team ID. To retrieve a Team ID, run astro workspace team list.
--roleThe Team's role in the Workspace.Possible values are WORKSPACE_VIEWER, WORKSPACE_EDITOR, or WORKSPACE_ADMIN.

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.