# Listar etiquetas

> plazbot tags list: catálogo de etiquetas del workspace con su ID y color.

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

### Listar etiquetas

Muestra el catálogo de etiquetas activas del workspace con su ID y color. Necesitas el ID (`mot_...`) para etiquetar un contacto con [`contacts update --add-tag`](https://developers.plazbot.com/cli/contacts/update). También funciona como `plazbot tag list`.

```bash
plazbot tags 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 }`. |

Las etiquetas eliminadas no aparecen. Para verlas usa `plazbot workspace show tags --include-inactive` (ver [workspace](https://developers.plazbot.com/cli/workspace)).

### Ejemplos

```bash
# Listar las etiquetas
plazbot tags list

# Obtener el ID de una etiqueta por su nombre
plazbot tags list --json | jq -r '.data[] | select(.name == "VIP") | .id'
```

### Resultado

```text
Tags (2)
────────────────────────────────────────
┌───────────────┬──────────────────┬─────────┐
│ ID            │ Name             │ Color   │
├───────────────┼──────────────────┼─────────┤
│ mot_AbcDef123 │ VIP              │ #22c55e │
├───────────────┼──────────────────┼─────────┤
│ mot_GhiJkl456 │ Conversar con IA │ #c084fc │
└───────────────┴──────────────────┴─────────┘
```

### Salida JSON

```json
{
"data": [
  {
    "id": "mot_AbcDef123",
    "name": "VIP",
    "color": "#22c55e",
    "status": 1,
    "userCreation": "usr_AbcDef123",
    "creationDate": "2026-06-25T15:13:58.619Z"
  }
],
"nextCursor": null
}
```

### Errores comunes

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