> ## 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.

# Crear un enlace para compartir una plantilla

> Crea un enlace para compartir una plantilla privada, en modo de uso o de copia completa, con un límite de usos y una caducidad opcionales.

Esta llamada crea un enlace para compartir una plantilla privada y responde `201` con el enlace y su token. **El token solo se muestra en esta respuesta y no puede recuperarse**: guárdalo ahora. Solo se guarda un hash de él, y la respuesta no se guarda en caché. Un token empieza por `vtpl_`.

Un enlace tiene uno de dos modos. Un enlace `use` permite a quien lo abre crear sus propias aplicaciones desde la plantilla, sin copiarla. Un enlace `full_copy` le da una plantilla privada propia, independiente de la tuya, que cuenta contra su límite de 5 plantillas privadas. `full_copy` necesita `share.full_copy` en `true` en la plantilla, y no está disponible para una [plantilla cerrada](https://docs.vertracloud.app/es-es/templates/use/closed-templates.md) ni para una versión que tenga variables `env_hidden`. Lee [Enlaces para compartir](https://docs.vertracloud.app/es-es/templates/create/share-links.md) antes de elegir.

Necesita el ámbito `templates:write` cuando se llama con una clave de API. Solo el propietario de la plantilla puede crear enlaces; en un workspace, un miembro ni siquiera puede listarlos. Quienes reciben el enlace ven el aviso "No verificado por Vertra" en la vista previa.

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

El ID de la plantilla.

**workspace\_id** `string`

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

**mode** `string`

`use` o `full_copy`. Por defecto, `use`.

**max\_uses** `integer`

El número máximo de usos. Si no se indica, no hay límite. Un uso se cuenta cuando alguien empieza a crear desde el enlace; un uso rechazado o deshecho se devuelve.

**expires\_in\_days** `integer`

El número de días hasta que el enlace caduca. Si no se indica, el enlace no caduca.

```bash cURL theme={null}
curl -X POST https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
  -H "Authorization: Bearer $VERTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "use", "max_uses": 10, "expires_in_days": 7 }'
```

### Respuesta

**response** `object`

El enlace.

**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.

**token** `string`

El token completo. Se muestra una vez.

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

### 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:write` (`403`).
* `TEMPLATE_NOT_FOUND`: La plantilla no existe, está eliminada o no es tuya (`404`).
* `TEMPLATE_SAVE_NOT_ALLOWED`: Se pidió `full_copy` y la plantilla no lo permite (`share.full_copy` no es `true`) (`403`).
* `TEMPLATE_CLOSED`: Se pidió `full_copy` para una plantilla cerrada (`403`).
* `VALIDATION_ERROR`: `max_uses` o `expires_in_days` no es un entero positivo (`400`).
* `WORKSPACE_OWNER_ONLY`: Solo el propietario del workspace crea enlaces para sus plantillas.

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


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