# Eliminar una etiqueta

> plazbot tags delete: quita una etiqueta del catálogo del workspace.

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

### Eliminar una etiqueta

Quita una etiqueta del catálogo del workspace. Antes comprueba que exista y muestra su nombre en la confirmación. Pide confirmación salvo que pases `--yes`.

Ten en cuenta que los contactos dejan de tenerla, y las reglas, vistas y automatizaciones que filtran por esa etiqueta dejan de coincidir. Revisa dónde se usa antes de eliminarla.

```bash
plazbot tags delete <tagId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| ID de la etiqueta | `<tagId>` | Sí | ID `mot_...` (sale en [`tags list`](https://developers.plazbot.com/cli/tags/list)). |
| Confirmar | `-y, --yes` | No | No pide confirmación. |
| Workspace | `-w, --workspace <id>` | No | Workspace de la etiqueta. Por defecto, el activo. |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU`. Por defecto, la zona activa. |
| JSON | `--json` | No | Imprime la respuesta de la API en JSON. |

### Ejemplos

```bash
# Eliminar una etiqueta (pide confirmación)
plazbot tags delete mot_AbcDef123

# Desde un script
plazbot tags delete mot_AbcDef123 --yes --json
```

Para quitar una etiqueta solo a un contacto (sin borrarla del catálogo) usa [`contacts update --remove-tag`](https://developers.plazbot.com/cli/contacts/update).

### Resultado

```text
? Delete tag "VIP"? Contacts lose it and rules or automations that use it stop matching. Yes

Tag "VIP" deleted
```

### Salida JSON

La respuesta de la API, o `{ "deleted": "mot_AbcDef123" }` si la API no devuelve cuerpo.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Tag mot_... not found in workspace ...` | El ID no existe o ya fue eliminada | Revisa el ID con [`tags list`](https://developers.plazbot.com/cli/tags/list) |
| `This action needs confirmation and there is no interactive terminal.` | Sin terminal y sin `--yes` | Agrega `--yes` |
| `This session is read-only: it cannot change data.` | La sesión se creó con `plazbot login --read-only` | Inicia sesión sin `--read-only` |
