# Agregar Enlace a Portal

> Agrega un enlace a la navegación del portal

Fuente: https://developers.plazbot.com/cli/portal/add-link/

### Agregar un enlace

Agrega un enlace a la navegación del portal, por ejemplo a tu documentación, precios o página de contacto.

```bash
plazbot portal add-link <portalId> -t <título> -u <url>
```

### 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)) |
| Título | `-t, --title <title>` | Sí | Texto del enlace |
| URL | `-u, --url <url>` | Sí | URL completa, con `http://` o `https://` |
| JSON | `--json` | No | Imprime el resultado en JSON |

### Ejemplos

```bash
# Enlace a la documentación
plazbot portal add-link por_AbcDef123 -t "Docs" -u https://docs.example.com

# Enlace de contacto
plazbot portal add-link por_AbcDef123 -t "Contáctanos" -u https://example.com/contact

# Agregar y obtener el resultado en JSON
plazbot portal add-link por_AbcDef123 -t "Precios" -u https://example.com/pricing --json
```

### Resultado

```text
✔ Link "Docs" added
```

### Salida JSON

```json
{
"portalId": "por_AbcDef123",
"title": "Docs",
"url": "https://docs.example.com",
"added": true
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Invalid URL for --url: "..."` | La URL no es válida o no usa `http://` o `https://` | Usa una URL completa, por ejemplo `https://docs.example.com` |
| `Link title cannot be empty.` | `-t ""` | Pasa un texto para el enlace |
| `Resource not found.` | El portal no existe en el workspace activo | Revisa el ID con `plazbot portal list` |

> **Tip:** No hay un comando para quitar un solo enlace: usa [`plazbot portal clear-links`](https://developers.plazbot.com/cli/portal/clear-links) y vuelve a agregar los que quieras conservar.