The behavior and format of this command differs depending on what Astronomer product you’re using. Use the following tabs to change product contexts.
Astro
APC
List all users with access to your current Workspace.
Usage (Astro)
astro workspace user list
Options (Astro)
Option
Description
Possible Values
--json
Output the response as JSON. Shorthand for --output json. Mutually exclusive with -o/--output.
None
-o,--output
Format the output. The default is table.
table, json, or template
--template
Format the output using a Go template. Use with --output template.
Any valid Go template string
Output
Output
Description
Data Type
FULLNAME
The full name of the user.
String
EMAIL
The email address associated with the user account.
String
ID
The user ID.
String
WORKSPACE ROLE
The level of permissions granted to the user in this Workspace. Possible values can be WORKSPACE_ACCESSOR, WORKSPACE_MEMBER, WORKSPACE_AUTHOR, WORKSPACE_OPERATOR, or WORKSPACE_OWNER.
Outputs a list of all users with access to your current Workspace.
Usage (APC)
astro workspace user list
Options (APC)
Option
Description
Possible Values
--workspace-id
The Workspace for which you want to list users. Specify this flag if you want to search for users in a Workspace that is different than your current Workspace.
Any valid Workspace ID
--email
The email address for the user you’re searching for.
Any string
--name
The name of the user to search for.
Any string
--paginated
Paginate the list of users. If --page-size is not specified, the default page size is 20.
