Producto
CLI

Eliminar Portal

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

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
01plazbot portal delete <portalId> [--yes]

Parámetros

ParámetroFlagRequeridoDescripción
Portal ID<portalId>SíID del portal (sale en plazbot portal list)
Confirmar-y, --yesNoOmite la confirmación (scripts y CI)
JSON--jsonNoImprime el resultado en JSON (requiere --yes)

Ejemplos

bash
01# Eliminar un portal (pide confirmación)
02plazbot portal delete por_AbcDef123
03 
04# Sin confirmación, para scripts y CI
05plazbot portal delete por_AbcDef123 --yes
06 
07# Eliminar y obtener el resultado en JSON
08plazbot portal delete por_AbcDef123 --yes --json

Resultado

text
01 Portal to delete
02 ────────────────────────────────────────
03 ID: por_AbcDef123
04 Name: Help Center
05 URL: https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123
06 
07? Delete portal "Help Center"? Its public URL will stop working. Yes
08✔ Portal "Help Center" deleted

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

Salida JSON

json
01{
02 "id": "por_AbcDef123",
03 "deleted": true
04}

Errores comunes

MensajeCausaSolución
This action needs confirmation and there is no interactive terminal.Sin terminal interactiva (CI, pipes o --json) y sin --yesAgrega --yes
Resource not found.El portal no existe en el workspace activoRevisa el ID con plazbot portal list

No se puede deshacer. Después de eliminarlo puedes crear un portal nuevo con plazbot portal create, pero tendrá otro ID y otra URL.

¿Quieres probar la API en vivo? Abre el Playground.