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 }'
{
"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"
}
}
Enlaces para compartir
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.
POST
/
v1
/
templates
/
{template_id}
/
share-links
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 }'
{
"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"
}
}
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 ni para una versión que tenga variables env_hidden. Lee Enlaces para compartir 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.
string
requerido
El ID de la plantilla.
string
Si la plantilla pertenece a un workspace, el ID del workspace.
string
use o full_copy. Por defecto, use.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.
integer
El número de días hasta que el enlace caduca. Si no se indica, el enlace no caduca.
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
object
El enlace.
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.
string
El token completo. Se muestra una vez.
{
"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
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, está eliminada o no es tuya (404).TEMPLATE_SAVE_NOT_ALLOWED: Se pidiófull_copyy la plantilla no lo permite (share.full_copyno estrue) (403).TEMPLATE_CLOSED: Se pidiófull_copypara una plantilla cerrada (403).VALIDATION_ERROR:max_usesoexpires_in_daysno es un entero positivo (400).WORKSPACE_OWNER_ONLY: Solo el propietario del workspace crea enlaces para sus plantillas.
{
"code": "TEMPLATE_CLOSED"
}
Última modificación el 28 de octubre de 2026