> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar los enlaces para compartir de una plantilla

> Lista los enlaces para compartir de una plantilla privada con su modo, usos, límite, caducidad y revocación, sin los tokens.

Esta llamada lista todos los enlaces para compartir de una plantilla privada, incluidos los revocados y los caducados, para que veas cómo se usa cada uno. Los tokens nunca se vuelven a devolver: cada enlace muestra solo los últimos 4 caracteres (`last4`) para distinguirlos.

Necesita el ámbito `templates:read` cuando se llama con una clave de API. Solo el propietario de la plantilla puede listar sus enlaces; un miembro del workspace no puede.

**template\_id** `string` *required*

El ID de la plantilla.

**workspace\_id** `string`

Si la plantilla pertenece a un workspace, el ID del workspace.

```bash cURL theme={null}
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Respuesta

**response** `object[]`

Los enlaces.

**Mostrar objeto**

**id** `string`

El ID del enlace.

**template\_id** `string`

La plantilla a la que pertenece el enlace.

**mode** `string`

`use` o `full_copy`.

**last4** `string`

Los últimos 4 caracteres del token, para distinguir los enlaces.

**uses** `integer`

Cuántas veces se usó el enlace.

**max\_uses** `integer | null`

El número máximo de usos, o `null` si no hay límite.

**expires\_at** `string | null`

Cuándo caduca el enlace, o `null` si no caduca.

**revoked\_at** `string | null`

Cuándo lo revocó el autor, o `null`.

**created\_at** `string`

Cuándo se creó el enlace.

```json Response theme={null}
{
  "response": [
    {
      "id": "lnk-abc123def456",
      "template_id": "tpl-abc123def456",
      "mode": "use",
      "last4": "x9Qa",
      "uses": 3,
      "max_uses": 10,
      "expires_at": "2026-11-03T14:02:00Z",
      "revoked_at": null,
      "created_at": "2026-10-27T14:02:00Z"
    }
  ]
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `API_KEY_SCOPE_DENIED`: La clave de API no tiene el ámbito `templates:read` (`403`).
* `TEMPLATE_NOT_FOUND`: La plantilla no existe o no es tuya (`404`).
* `WORKSPACE_OWNER_ONLY`: Solo el propietario del workspace lista los enlaces de sus plantillas.

```json Error Response theme={null}
{
  "code": "TEMPLATE_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.