# Ver Portal del Workspace

> Muestra el portal del workspace activo, con el ID que piden los demás comandos de portal

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

### Ver el portal del workspace

Muestra el portal del workspace activo, incluido el ID que piden los demás comandos de portal. Cada workspace tiene como máximo un portal, así que el comando muestra ese único portal.

```bash
plazbot portal list [--json]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| JSON | `--json` | No | Imprime el portal en JSON (`null` si no hay portal) |

### Ejemplos

```bash
# Ver el portal del workspace activo
plazbot portal list

# Obtener el portal en JSON
plazbot portal list --json

# Extraer solo el ID del portal
plazbot portal list --json | jq -r '.id'
```

### Resultado

```text
Workspace portal
────────────────────────────────────────
ID: por_AbcDef123
Name: Help Center
URL: https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123
Access: direct
Status: Enabled
Title: ¿En qué podemos ayudarte?
Plazbot brand: Visible
```

Si el portal tiene logos, enlaces o agentes, aparecen debajo en las secciones **Assets**, **Links** y **Agents**, igual que en [`plazbot portal get`](https://developers.plazbot.com/cli/portal/get).

### Salida JSON

El objeto del portal tal como lo devuelve la API (mismo formato que [`portal get --json`](https://developers.plazbot.com/cli/portal/get)). Si el workspace no tiene portal, imprime `null` y termina con código `1`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `This workspace has no portal yet.` | El workspace no tiene portal (código de salida `1`) | Crea uno con [`plazbot portal create`](https://developers.plazbot.com/cli/portal/create) |
| `You are not signed in.` | No hay sesión | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |

> **Tip:** En un script, el código de salida te dice si existe el portal: `plazbot portal list --json > /dev/null 2>&1 || plazbot portal create -n "Help Center" -t "Bienvenido"`.