# GET /v1/telegram/links

Listar enlaces de Telegram

Enlaces de Telegram activos y bloqueados de este editor. Los identificadores de chat son privados. Devuelve enabled:false cuando Telegram no está disponible. Requiere el scope `publisher:read` (clave de API o sesión web). Nivel de límite de uso: `read`.

- Scope requerido: `publisher:read`
- Límite de uso: `read` — 120 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

Sin parámetros.

## Respuesta

```
{ bot_username: string | null; enabled: boolean; links: { created_at: string; id: integer; locale: "en" | "vi" | "es" | "pt" | "fr" | "id" | "ru" | "zh" | "ar"; status: "active" | "blocked"; tg_username: string | null }[]; max_links: 3 }
```

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |

Documentación HTML: https://agimone.com/es/developers/api/#list-telegram-links
API 2026-10
