curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/copy \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
{
"response": {
"id": "tpl-999888777666",
"slug": "support-bot-copy",
"origin": "private",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"author_display": "Ana",
"current_version": { "id": "tplv-444333222111", "version": "1.0.0", "security": false, "created_at": "2026-10-27T17:00:00Z" },
"github": null,
"owner": { "user_id": "9876543210987654321", "workspace_id": null }
}
}
Enlaces para compartir
Copiar una plantilla desde un enlace para compartir de copia completa
Te da una plantilla privada propia, independiente del autor, a partir de un enlace de copia completa, y cuenta contra tu límite de 5.
POST
/
v1
/
share
/
templates
/
{token}
/
copy
curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/copy \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
{
"response": {
"id": "tpl-999888777666",
"slug": "support-bot-copy",
"origin": "private",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"author_display": "Ana",
"current_version": { "id": "tplv-444333222111", "version": "1.0.0", "security": false, "created_at": "2026-10-27T17:00:00Z" },
"github": null,
"owner": { "user_id": "9876543210987654321", "workspace_id": null }
}
}
Esta llamada convierte un enlace
full_copy en una plantilla privada que te pertenece y responde 201 con ella. Después nada vincula la copia con el autor: si el autor elimina la plantilla, la imagen o la cuenta, tu copia no cambia, y no recibes actualizaciones del original. El código y cualquier imagen se copian a tu cuenta; los secretos que el autor ocultó nunca llegan con ella, y el nombre del autor se mantiene como crédito. La copia cuenta contra tu límite de 5 plantillas privadas y, en una plantilla con imágenes, ocupa un slot de imagen por cada imagen distinta.
Requiere una cuenta (una sesión o una clave de API con el ámbito templates:write). Se aplican las reglas de plan de Crear una plantilla privada, y en un workspace solo su propietario puede recibir una copia. El permiso se comprueba en el momento de la llamada: si el autor quitó share.full_copy después de crear el enlace, la llamada falla con SHARE_LINK_REVOKED y no se gasta ningún uso. Un enlace use se rechaza aquí con 400: usa Usar enlace.
string
requerido
El token del enlace.
string
El workspace que será propietario de la copia. Si no se indica, la copia es tuya.
curl -X POST https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN/copy \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Respuesta
La plantilla privada de Crear una plantilla privada, con201 Created. Su slug es el original, o el primero libre de entre <slug>-copy, <slug>-copy-2 y así sucesivamente; author_display acredita al autor original.
{
"response": {
"id": "tpl-999888777666",
"slug": "support-bot-copy",
"origin": "private",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"author_display": "Ana",
"current_version": { "id": "tplv-444333222111", "version": "1.0.0", "security": false, "created_at": "2026-10-27T17:00:00Z" },
"github": null,
"owner": { "user_id": "9876543210987654321", "workspace_id": null }
}
}
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).SHARE_LINK_NOT_FOUND: El token tiene un formato no válido, no existe, o su plantilla fue eliminada (404).SHARE_LINK_REVOKED: El enlace fue revocado, o el autor ya no permite copias completas (410).SHARE_LINK_EXPIRED,SHARE_LINK_EXHAUSTED: El enlace caducó o alcanzó sumax_uses(410).TEMPLATE_PRIVATE_LIMIT_REACHED: Ya tienes 5 plantillas privadas.PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: Tu plan no permite crear plantillas.TEMPLATE_IMAGE_SLOTS_EXHAUSTED: La copia necesita más slots de imagen de los que tienes libres.WORKSPACE_OWNER_ONLY: Solo el propietario del workspace recibe una copia en él.
{
"code": "TEMPLATE_PRIVATE_LIMIT_REACHED"
}
Última modificación el 28 de octubre de 2026