> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro workspace user list

> List Workspace users.

> [!NOTE]
>
> The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.

> [tab] Astro
>
> List all users with access to your current Workspace.
>
> ## Usage
>
> ```sh wrap theme={null}
> astro workspace user list
> ```
>
> ## Options
>
> | 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`. | String |
> | `CREATE DATE` | The date the user profile was created. | Date (`YYYY-MM-DDTHH:MM:SSZ`) |
>
> ## Related commands
>
> * [`astro workspace user update`](https://astronomer.io/docs/cli/v1.46/astro-workspace-user-update)
> * [`astro workspace user remove`](https://astronomer.io/docs/cli/v1.46/astro-workspace-user-remove)
> * [`astro organization user list`](https://astronomer.io/docs/cli/v1.46/astro-organization-user-list)

> [tab] APC
>
> Outputs a list of all users with access to your current Workspace.
>
> ## Usage
>
> ```sh wrap theme={null}
> astro workspace user list
> ```
>
> ## Options
>
> | 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. | None |
> | `--page-size` | The page size for paginated lists. | Any integer |
>
> ## Related documentation
>
> * [Manage Workspaces and Deployments on Astronomer](https://astronomer.io/docs/astro-private-cloud/v-0-37/manage-workspaces.md)
> * [Manage User Permissions on Astronomer](https://astronomer.io/docs/astro-private-cloud/v-0-37/workspace-permissions.md)
