> ## 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.

**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.47/astro-workspace-user-update)
* [`astro workspace user remove`](https://astronomer.io/docs/cli/v1.47/astro-workspace-user-remove)
* [`astro organization user list`](https://astronomer.io/docs/cli/v1.47/astro-organization-user-list)

**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)