# Eliminar un worker

> Elimina un worker del workspace de forma permanente.

Fuente: https://developers.plazbot.com/cli/workers/remove/

### Eliminar un worker

Elimina un worker del workspace. Antes de borrar muestra sus datos (nombre, tipo, estado, ejecuciones) y pide confirmación; con `--yes` la omite.

```bash
plazbot workers remove <nombre> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Nombre | `<nombre>` | Sí | Nombre del worker a eliminar. |
| Confirmar | `-y, --yes` | No | Omite la confirmación (para scripts y CI). |
| JSON | `--json` | No | Imprime el resultado como JSON. Requiere `--yes`. |

### Ejemplos

```bash
# Eliminar con confirmación
plazbot workers remove get-stock

# Eliminar sin confirmación (scripts/CI)
plazbot workers remove get-stock --yes

# Eliminar y obtener el resultado en JSON
plazbot workers remove get-stock --yes --json
```

### Resultado

```text
You are about to delete this worker:
──────────────────────────────────────────────────
Name: get-stock
Type: tool
Status: active
Executions: 128
──────────────────────────────────────────────────
✔ Delete worker "get-stock"? This cannot be undone. Yes
✔ Worker "get-stock" deleted
```

Si respondes que no, imprime `Aborted.` y termina con código 1.

### Salida JSON

```json
{ "name": "get-stock", "removed": true }
```

### Qué sucede al eliminar

- Si era un tool, los agentes ya no pueden invocarlo.
- Si era un webhook, su URL deja de funcionar.
- Si era un schedule o sync, deja de ejecutarse.

> **Importante:** Esta acción no se puede deshacer. Conserva el archivo fuente para poder volver a desplegarlo con [`plazbot workers deploy`](https://developers.plazbot.com/cli/workers/deploy).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Worker "<nombre>" not found.` | No existe un worker con ese nombre. | Revisa el nombre con [`plazbot workers list`](https://developers.plazbot.com/cli/workers/list). |
| `This action needs confirmation and there is no interactive terminal.` | Sin terminal interactiva (CI, pipes o `--json`) y sin `--yes`. | Agrega `--yes`. |
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |