# Eliminar Portal

> Elimina un portal; su URL pública deja de funcionar

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

### Eliminar un portal

Elimina un portal. Su URL pública deja de funcionar. Los agentes asociados no se eliminan. Muestra el portal y pide confirmación antes de borrarlo.

```bash
plazbot portal delete <portalId> [--yes]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Portal ID | `<portalId>` | Sí | ID del portal (sale en [`plazbot portal list`](https://developers.plazbot.com/cli/portal/list)) |
| Confirmar | `-y, --yes` | No | Omite la confirmación (scripts y CI) |
| JSON | `--json` | No | Imprime el resultado en JSON (requiere `--yes`) |

### Ejemplos

```bash
# Eliminar un portal (pide confirmación)
plazbot portal delete por_AbcDef123

# Sin confirmación, para scripts y CI
plazbot portal delete por_AbcDef123 --yes

# Eliminar y obtener el resultado en JSON
plazbot portal delete por_AbcDef123 --yes --json
```

### Resultado

```text
Portal to delete
────────────────────────────────────────
ID: por_AbcDef123
Name: Help Center
URL: https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123

? Delete portal "Help Center"? Its public URL will stop working. Yes
✔ Portal "Help Center" deleted
```

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

### Salida JSON

```json
{
"id": "por_AbcDef123",
"deleted": true
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `This action needs confirmation and there is no interactive terminal.` | Sin terminal interactiva (CI, pipes o `--json`) y sin `--yes` | Agrega `--yes` |
| `Resource not found.` | El portal no existe en el workspace activo | Revisa el ID con `plazbot portal list` |

> **Importante:** No se puede deshacer. Después de eliminarlo puedes crear un portal nuevo con [`plazbot portal create`](https://developers.plazbot.com/cli/portal/create), pero tendrá otro ID y otra URL.
