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

<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
    ```

    ## 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.40/astro-workspace-user-update)
    * [`astro workspace user remove`](/docs/cli/v1.40/astro-workspace-user-remove)
    * [`astro organization user list`](/docs/cli/v1.40/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>