curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"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"
}
}
Enlaces para compartir
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.
DELETE
/
v1
/
templates
/
{template_id}
/
share-links
/
{link_id}
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"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"
}
}
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.
string
requerido
El ID de la plantilla.
string
requerido
El ID del enlace.
string
Si la plantilla pertenece a un workspace, el ID del workspace.
curl -X DELETE https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links/lnk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
El enlace, con
revoked_at completado.Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID del enlace.
string
La plantilla a la que pertenece el enlace.
string
use o full_copy.string
Los últimos 4 caracteres del token, para distinguir los enlaces.
integer
Cuántas veces se usó el enlace.
integer | null
El número máximo de usos, o
null si no hay límite.string | null
Cuándo caduca el enlace, o
null si no caduca.string | null
Cuándo lo revocó el autor, o
null.string
Cuándo se creó el enlace.
{
"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
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 ámbitotemplates: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.
{
"code": "SHARE_LINK_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026