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

> [!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.

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

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

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