curl -X POST https://api.vertracloud.app/v1/templates/from-app/app-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "support-bot",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"member": {
"resource_id": "app-abc123def456",
"service_id": "bot",
"env": [
{ "key": "DISCORD_TOKEN", "mode": "question", "label": { "pt-br": "Token do bot", "en": "Bot token" } },
{ "key": "LOG_LEVEL", "mode": "keep" }
]
}
}'
{
"response": {
"id": "tpl-abc123def456",
"slug": "support-bot",
"origin": "private",
"visibility": "public",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"tags": [],
"current_version": { "id": "tplv-111222333444", "version": "1.0.0", "security": false, "created_at": "2026-10-27T14:02:00Z" },
"creates_stack": false,
"inputs": [
{ "id": "discord_token", "type": "secret", "label": { "pt-br": "Token do bot", "en": "Bot token" } }
],
"created_at": "2026-10-27T14:02:00Z",
"updated_at": "2026-10-27T14:02:00Z"
}
}
Plantillas
Guardar una aplicación como plantilla
Guarda una de tus aplicaciones como plantilla privada, eligiendo qué variables se convierten en preguntas y qué archivos se incluyen.
POST
/
v1
/
templates
/
from-app
/
{app_id}
curl -X POST https://api.vertracloud.app/v1/templates/from-app/app-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "support-bot",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"member": {
"resource_id": "app-abc123def456",
"service_id": "bot",
"env": [
{ "key": "DISCORD_TOKEN", "mode": "question", "label": { "pt-br": "Token do bot", "en": "Bot token" } },
{ "key": "LOG_LEVEL", "mode": "keep" }
]
}
}'
{
"response": {
"id": "tpl-abc123def456",
"slug": "support-bot",
"origin": "private",
"visibility": "public",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"tags": [],
"current_version": { "id": "tplv-111222333444", "version": "1.0.0", "security": false, "created_at": "2026-10-27T14:02:00Z" },
"creates_stack": false,
"inputs": [
{ "id": "discord_token", "type": "secret", "label": { "pt-br": "Token do bot", "en": "Bot token" } }
],
"created_at": "2026-10-27T14:02:00Z",
"updated_at": "2026-10-27T14:02:00Z"
}
}
Esta llamada guarda una aplicación como plantilla privada con una primera versión y responde
201 con la plantilla. Los valores de las variables nunca se copian, salvo que elijas keep para una variable que no parece una credencial. Llama primero a Revisar borrador de plantilla para ver lo que propone la plataforma.
Requiere el scope templates:write cuando se llama con una clave de API. Se aplican el mismo plan, el límite de 5 plantillas y las reglas de workspace de Crear una plantilla privada, y la plantilla no la verifica Vertra Cloud. No se puede guardar una aplicación que llegó desde un enlace para compartir (TEMPLATE_SAVE_NOT_ALLOWED), ni tampoco una aplicación de una plantilla cerrada (TEMPLATE_CLOSED). Una aplicación que ejecuta una imagen de la plataforma tampoco se puede guardar.
string
requerido
El ID de la aplicación.
string
Si la aplicación pertenece a un workspace, el ID del workspace.
string
requerido
El slug de la plantilla: letras minúsculas, dígitos y guiones.
object
requerido
El nombre por idioma:
pt-br (obligatorio), en y es, de hasta 50 caracteres cada uno.object
requerido
La descripción por idioma, con la misma forma que
name, de hasta 128 caracteres cada uno.string
requerido
automation, ai-agents, bots, apis, cms, monitoring, starters, databases u other.string[]
Hasta 10 etiquetas.
string
La primera versión, como versión semántica. Por defecto
1.0.0.object
Lo que pueden hacer los usuarios de la plantilla, como en los permisos del manifiesto. Los campos que no aparezcan toman los valores por defecto.
object
requerido
Lo que se guarda de la aplicación.
Mostrar Objeto member
Mostrar Objeto member
string
requerido
El ID de la aplicación o de la base de datos que se guarda.
string
requerido
El id que recibe el servicio en el manifiesto.
object[]
Una revisión por variable de una aplicación. Una variable sin revisión queda fuera de la plantilla. Cada revisión tiene:
key: el nombre de la variable.mode:question(se convierte en una pregunta que responde el usuario; el valor no se copia),keep(el valor se copia; se rechaza cuando parece una credencial),generate(se convierte en un secreto que la plataforma genera para cada usuario, congenerateigual arandom:<n>ouuid),hidden(se copia, pero se oculta a quien usa la plantilla; el valor queda fuera de su vista) uomit(se deja fuera).labelyhelp: textos por idioma (pt-br,en,es), usados porquestionygenerate.generate: cómo se genera el secreto,random:<n>ouuid.
string[]
Las rutas de
/app de la aplicación que entran en la plantilla, para aplicaciones con código. Sin este campo, entra todo excepto lo que el borrador deja sin seleccionar. Los archivos .env*, la carpeta de la plataforma y las carpetas de dependencias nunca se pueden incluir.object
La memoria del servicio en MB:
min, recommended y max opcional.string
El workspace que será propietario de la plantilla. Sin este campo, la plantilla te pertenece.
curl -X POST https://api.vertracloud.app/v1/templates/from-app/app-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "support-bot",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"member": {
"resource_id": "app-abc123def456",
"service_id": "bot",
"env": [
{ "key": "DISCORD_TOKEN", "mode": "question", "label": { "pt-br": "Token do bot", "en": "Bot token" } },
{ "key": "LOG_LEVEL", "mode": "keep" }
]
}
}'
Response
El mismo objeto de plantilla que devuelve Crear una plantilla privada, con201 Created: id, slug, origin (private), name, description, category, tags, current_version, services, inputs, permissions, outputs y los demás campos listados allí.
{
"response": {
"id": "tpl-abc123def456",
"slug": "support-bot",
"origin": "private",
"visibility": "public",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"tags": [],
"current_version": { "id": "tplv-111222333444", "version": "1.0.0", "security": false, "created_at": "2026-10-27T14:02:00Z" },
"creates_stack": false,
"inputs": [
{ "id": "discord_token", "type": "secret", "label": { "pt-br": "Token do bot", "en": "Bot token" } }
],
"created_at": "2026-10-27T14:02:00Z",
"updated_at": "2026-10-27T14:02:00Z"
}
}
Error Responses
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 scopetemplates:write(403).APP_NOT_FOUND: La aplicación no existe o no es tuya.TEMPLATE_SAVE_NOT_ALLOWED: La aplicación llegó desde un enlace para compartir, o ejecuta una imagen de la plataforma (403).TEMPLATE_CLOSED: La aplicación procede de una plantilla cerrada (403).TEMPLATE_MANIFEST_INVALID: El resultado no es un manifiesto válido, o una variablekeepcontiene algo que parece una credencial;details.issuesenumera los hallazgos.TEMPLATE_SECRET_IN_SOURCE: Un archivo seleccionado de/appcontiene un secreto;details.filesenumera las rutas (400).TEMPLATE_SLUG_TAKEN: El slug ya está en uso entre tus plantillas o está reservado.TEMPLATE_PRIVATE_LIMIT_REACHED: La cuenta ya tiene 5 plantillas privadas.PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: El plan no puede crear plantillas.WORKSPACE_OWNER_ONLY: Solo el propietario del workspace guarda plantillas en él.
{
"code": "TEMPLATE_SAVE_NOT_ALLOWED"
}
Última modificación el 28 de octubre de 2026