> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt.

# Team commands

This topic covers team commands for the [Postman CLI](/docs/postman-cli/postman-cli-overview/).

Use the `postman team` commands to work with the teams inside your Postman organization. These are the teams within the organization, not the organization itself.

> **Info**
>
> To use these commands, sign in to Postman with [the `postman login` command](/docs/postman-cli/postman-cli-auth/#postman-login), or set a [Postman API key](/docs/reference/postman-api/authentication/#generate-a-postman-api-key) in the `POSTMAN_API_KEY` environment variable.

## `postman team list`

Lists the teams inside your organization, with each team's ID. Use it to find the team you want, for example to create a workspace in a specific team with [`postman workspace create`](/docs/postman-cli/postman-cli-workspace/#postman-workspace-create) and its `--team-id` option.

Listing teams requires a Postman organization that has the teams feature. When you're signed in to a team that doesn't have it, the command prints an error to `stderr` and exits with code `1` instead of listing anything:

```
Error: Squad feature is not available for your team.
```

### Usage

```bash
postman team list [options]
```

### Options

**`--can-create-workspace`**

Lists only the teams you can create a workspace in.

---

**`--json`**

Prints the list as JSON for machine-readable output.

---

**`--timeout <ms>`** — default: 30000

Stops the command after this many milliseconds.

---

### Examples

```bash
postman team list

postman team list --can-create-workspace

postman team list --json
```