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

> List Teams in a Workspace.

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

List all Teams in your current Workspace, as well as their level of user permissions within the Workspace.

<Tabs>
  <Tab title="Astro">
    ## Usage

    ```sh wrap theme={null}
    astro workspace team 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 |
    | - | - | - |
    | `ID` | The Team ID. | String |
    | `Role` | The Team's role in the Workspace. | String |
    | `Name` | The name of the Team. | String |
    | `Description` | The Team description. | String |
    | `Create Date` | The date and time that the Team was created in the Organization. | Date (`YYYY-MM-DDTHH:MM:SSZ`) |

    ## Related commands

    * [`astro workspace team add`](/docs/cli/v1.46/astro-workspace-team-add)
    * [`astro organization team create`](/docs/cli/v1.46/astro-organization-team-create)
    * [`astro organization team list`](/docs/cli/v1.46/astro-organization-team-list)
    * [`astro workspace switch`](/docs/cli/v1.46/astro-workspace-switch)
  </Tab>

  <Tab title="APC">
    ## Usage

    ```sh wrap theme={null}
    astro workspace team list <options>
    ```

    ## Options

    | Option | Description | Valid Values |
    | - | - | - |
    | `<workspace_id>` | The Workspace you want to list Teams for. | Any valid Workspace ID |

    ## Output

    | Output | Description | Data Type |
    | - | - | - |
    | `ID` | The Team ID. | String |
    | `Role` | The Team's role in the Workspace. | String |
    | `Name` | The name of the Team. | String |
    | `Description` | The Team description. | Boolean |
    | `Create Date` | The date and time that the Team was created in the Organization. | Date (`YYYY-MM-DDTHH:MM:SSZ`) |

    ## Related commands

    * [`astro workspace team add`](/docs/cli/v1.46/astro-workspace-team-add)
    * [`astro organization team create`](/docs/cli/v1.46/astro-organization-team-create)
    * [`astro organization team list`](/docs/cli/v1.46/astro-organization-team-list)
    * [`astro workspace switch`](/docs/cli/v1.46/astro-workspace-switch)
  </Tab>
</Tabs>