# Eliminar un secreto

> Elimina un secreto de los workers del workspace.

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

### Eliminar un secreto

Elimina un secreto del workspace de forma permanente. Pide confirmación antes de borrar; con `--yes` la omite.

```bash
plazbot workers secret remove <key> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Clave | `<key>` | Sí | Nombre del secreto a eliminar (ej: `STRIPE_API_KEY`). |
| 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 secret remove STRIPE_API_KEY

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

# Eliminar y obtener el resultado en JSON
plazbot workers secret remove OLD_TOKEN --yes --json
```

### Resultado

```text
✔ Delete secret "STRIPE_API_KEY"? Workers using plz.env.STRIPE_API_KEY will stop working. Yes
✔ Secret "STRIPE_API_KEY" deleted
```

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

### Salida JSON

```json
{ "key": "STRIPE_API_KEY", "removed": true }
```

> **Importante:** Los workers que usan el secreto recibirán `undefined` en `plz.env.STRIPE_API_KEY` desde su próxima ejecución. Revisa con [`plazbot workers secret list`](https://developers.plazbot.com/cli/workers/secret-list) y tu código antes de borrarlo.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Secret "<key>" not found.` | No existe un secreto con esa clave. | Revisa el nombre con [`plazbot workers secret list`](https://developers.plazbot.com/cli/workers/secret-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). |