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

<Info>The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.</Info>

<Tabs>
  <Tab title="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`](/docs/cli/v1.46/astro-workspace-user-update)
    * [`astro workspace user remove`](/docs/cli/v1.46/astro-workspace-user-remove)
    * [`astro organization user list`](/docs/cli/v1.46/astro-organization-user-list)
  </Tab>

  <Tab title="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](/docs/astro-private-cloud/v-0-37/manage-workspaces)
    * [Manage User Permissions on Astronomer](/docs/astro-private-cloud/v-0-37/workspace-permissions)
  </Tab>
</Tabs>