astro workspace user add

Add a user to a Workspace.

The behavior and format of this command differs depending on which Astronomer product you’re using. Use the following tabs to change product contexts.

Astro

Add an existing Organization user to your current Astronomer Workspace. You must be a Workspace Owner to perform this action.

You can use this command to invite multiple users to a Workspace at a time. See Add a group of users to Astro using the Astro CLI.

Usage

astro workspace user add <email>

Options

Option	Description	Valid Values
<email-address>	The email address of the user that you want to add to the Workspace.	Any valid email address
--role	The user’s role in the Workspace.	Possible values are either WORKSPACE_ACCESSOR, WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR, or WORKSPACE_OWNER.

Related commands

• astro workspace user update
• astro organization user invite
• astro organization user update

APC

Creates a new user in your current Workspace. If the user has already authenticated to Astronomer, they will automatically be granted access to the Workspace. If the user does not have an account on Astronomer, they will receive an email invitation to the platform.

Usage

astro workspace user add --email <user-email-address>

Options

Option	Description	Possible Values
--email (Required)	The user’s email	Any valid email address
--workspace-id	The Workspace that the user is added to. Specify this flag if you want to create a user in a Workspace that is different than your current Workspace.	Any valid Workspace ID
--role	The role assigned to the user.	Possible values are WORKSPACE_MEMBER, WORKSPACE_OPERATOR, and WORKSPACE_OWNER. Default value is WORKSPACE_MEMBER.

Related documentation

• Manage Workspaces and Deployments on Astronomer
• Manage User Permissions on Astronomer