# Listar el equipo

> plazbot team list: miembros del workspace con su ID de usuario, email y rol.

Fuente: https://developers.plazbot.com/cli/team/list/

### Listar el equipo

Muestra los miembros del workspace con su ID de usuario, email, rol y estado de la invitación. El ID de usuario (`usr_...`) es el que se usa para asignar contactos con [`contacts update --agent`](https://developers.plazbot.com/cli/contacts/update) o filtrar con [`contacts list --agent`](https://developers.plazbot.com/cli/contacts/list).

```bash
plazbot team list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Workspace | `-w, --workspace <id>` | No | Workspace a consultar. Por defecto, el activo. |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU`. Por defecto, la zona activa. |
| JSON | `--json` | No | Imprime `{ "data": [...], "nextCursor": null }`. |

### Ejemplos

```bash
# Miembros del workspace activo
plazbot team list

# IDs y emails separados por tabulador
plazbot team list --json | jq -r '.data[] | [.userId, .email] | @tsv'

# Solo los agentes
plazbot team list --json | jq '.data[] | select(.role == "agent")'
```

### Resultado

```text
Team (2)
────────────────────────────────────────
┌───────────────┬────────────┬─────────────────────┬───────────────┬────────────┬──────────────────┐
│ User ID       │ Name       │ Email               │ Role          │ Invitation │ Last seen        │
├───────────────┼────────────┼─────────────────────┼───────────────┼────────────┼──────────────────┤
│ usr_AbcDef123 │ Ana Pérez  │ ana@empresa.com     │ admin (owner) │ accepted   │ 2026-10-08 14:02 │
├───────────────┼────────────┼─────────────────────┼───────────────┼────────────┼──────────────────┤
│ usr_GhiJkl456 │ Luis Rojas │ luis@empresa.com    │ agent         │ pending    │ —                │
└───────────────┴────────────┴─────────────────────┴───────────────┴────────────┴──────────────────┘
```

| Columna | Descripción |
|---------|-------------|
| User ID | ID del usuario (`usr_...`). |
| Role | `admin`, `supervisor`, `commercial` o `agent`. `(owner)` marca al dueño del workspace. |
| Invitation | `accepted` o `pending`. |
| Last seen | Última actividad registrada (UTC). |

### Salida JSON

```json
{
"data": [
  {
    "userId": "usr_AbcDef123",
    "name": "Ana Pérez",
    "email": "ana@empresa.com",
    "role": "admin",
    "isOwner": true,
    "invitationAccepted": true,
    "voipExtension": "101",
    "lastSeenAt": "2026-10-08T14:02:11Z",
    "membershipId": "uxw_AbcDef123"
  }
],
"nextCursor": null
}
```

El CLI solo devuelve estos campos. Nunca muestra contraseñas, contraseñas de VoIP ni tokens de integraciones de los miembros.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |
| `No members` | El workspace no existe en esa zona o no tienes acceso | Revisa `-w` y `-z` |