curl -X POST https://api.vertracloud.app/v1/templates/tpl-abc123def456/versions \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-F 'manifest=<manifest.json' \
-F 'changelog={"pt-br":"Corrige o login","en":"Fixes login"}' \
-F 'sources[bot][email protected]'
{
"response": {
"id": "tplv-555666777888",
"version": "1.1.0",
"security": false,
"changelog": { "pt-br": "Corrige o login", "en": "Fixes login" },
"manifest": { "id": "support-bot", "version": "1.1.0", "category": "bots", "services": {} },
"created_at": "2026-10-27T15:30:00Z"
}
}
Plantillas
Publicar una nueva versión de una plantilla privada
Publica una nueva versión de una plantilla privada a partir de un manifiesto actualizado y, para los servicios con código, nuevos archivos ZIP.
POST
/
v1
/
templates
/
{template_id}
/
versions
curl -X POST https://api.vertracloud.app/v1/templates/tpl-abc123def456/versions \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-F 'manifest=<manifest.json' \
-F 'changelog={"pt-br":"Corrige o login","en":"Fixes login"}' \
-F 'sources[bot][email protected]'
{
"response": {
"id": "tplv-555666777888",
"version": "1.1.0",
"security": false,
"changelog": { "pt-br": "Corrige o login", "en": "Fixes login" },
"manifest": { "id": "support-bot", "version": "1.1.0", "category": "bots", "services": {} },
"created_at": "2026-10-27T15:30:00Z"
}
}
Esta llamada publica una nueva versión de una plantilla privada y responde
201 con la versión. La petición es multipart/form-data, igual que en Crear una plantilla privada. El número de versión del manifiesto debe ser mayor que el actual, y el id del manifiesto no puede cambiar. Una versión publicada nunca cambia, y un número que ya se usó queda reservado aunque su versión se haya eliminado.
Necesita el ámbito templates:write cuando se llama con una clave de API, y solo el propietario de la plantilla (en un workspace, su propietario) puede publicar. Un servicio code sin una nueva parte ZIP conserva el código de la versión anterior; si no tenía ninguno, la llamada falla con TEMPLATE_SOURCE_REQUIRED. Una variable listada en env_hidden y ausente de env conserva su valor anterior, y si la envías de nuevo, lo reemplaza. Las aplicaciones ya creadas desde la plantilla no se tocan: cada usuario actualiza cuando lo decide.
string
requerido
El ID de la plantilla.
string
requerido
El manifiesto de la nueva versión, como cadena JSON serializada.
file
Una parte ZIP con el nuevo código de un servicio, con el nombre del ID del servicio. Es opcional para un servicio que ya tiene código.
string
Qué cambió, como objeto JSON serializado con
pt-br (obligatorio), en y es.curl -X POST https://api.vertracloud.app/v1/templates/tpl-abc123def456/versions \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-F 'manifest=<manifest.json' \
-F 'changelog={"pt-br":"Corrige o login","en":"Fixes login"}' \
-F 'sources[bot][email protected]'
Respuesta
object
La nueva versión.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
{
"response": {
"id": "tplv-555666777888",
"version": "1.1.0",
"security": false,
"changelog": { "pt-br": "Corrige o login", "en": "Fixes login" },
"manifest": { "id": "support-bot", "version": "1.1.0", "category": "bots", "services": {} },
"created_at": "2026-10-27T15:30: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).TEMPLATE_MANIFEST_INVALID: El manifiesto no es válido, la versión no es mayor que la actual, o elidcambió;details.issueslista los hallazgos.TEMPLATE_SOURCE_REQUIRED: Un serviciocodeno tiene parte ZIP ni código de una versión anterior.TEMPLATE_SECRET_IN_SOURCE: Un ZIP contiene un secreto;details.fileslista las rutas (400).IMAGE_NOT_FOUND: Un servicioimageapunta a una imagen que no es tuya o que no tiene una compilación exitosa.WORKSPACE_OWNER_ONLY: Solo el propietario del workspace publica versiones de sus plantillas.
{
"code": "TEMPLATE_SOURCE_REQUIRED"
}
Última modificación el 28 de octubre de 2026