curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-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": "2026-11-03T14:02:00Z",
"revoked_at": null,
"created_at": "2026-10-27T14:02:00Z"
}
]
}
Enlaces para compartir
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.
GET
/
v1
/
templates
/
{template_id}
/
share-links
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-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": "2026-11-03T14:02:00Z",
"revoked_at": null,
"created_at": "2026-10-27T14:02:00Z"
}
]
}
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.
string
requerido
El ID de la plantilla.
string
Si la plantilla pertenece a un workspace, el ID del workspace.
curl https://api.vertracloud.app/v1/templates/tpl-abc123def456/share-links \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object[]
Los enlaces.
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": "2026-11-03T14:02:00Z",
"revoked_at": null,
"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: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.
{
"code": "TEMPLATE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026