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

# Revocar un enlace para compartir

> Revoca un enlace para compartir de una plantilla privada para que nadie pueda volver a usarlo, sin afectar a lo que ya se creó a partir de él.

Esta llamada revoca un enlace para compartir: no acepta ningún uso nuevo y deja de ofrecer actualizaciones a lo que se creó a partir de él. Las aplicaciones y los stacks ya creados desde el enlace siguen funcionando, y las copias ya hechas se quedan con sus propietarios. Revocar es idempotente: revocar un enlace ya revocado responde con el enlace tal como está.

Necesita el ámbito `templates:write` cuando se llama con una clave de API. Solo el propietario de la plantilla puede revocar sus enlaces.

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

El ID de la plantilla.

**link\_id** `string` *required*

El ID del enlace.

**workspace\_id** `string`

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

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

### Respuesta

**response** `object`

El enlace, con `revoked_at` completado.

**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": null,
    "revoked_at": "2026-10-27T16:00:00Z",
    "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:write` (`403`).
* `TEMPLATE_NOT_FOUND`: La plantilla no existe o no es tuya (`404`).
* `SHARE_LINK_NOT_FOUND`: El enlace no existe en esa plantilla (`404`).
* `WORKSPACE_OWNER_ONLY`: Solo el propietario del workspace revoca los enlaces de sus plantillas.

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


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