curl -X POST https://api.vertracloud.app/v1/templates/from-stack/stk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "api-with-postgres",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"description": { "pt-br": "API e banco prontos." },
"category": "apis",
"members": [
{ "resource_id": "app-abc123def456", "service_id": "api" },
{ "resource_id": "db-abc123def456", "service_id": "db" }
]
}'
{
"response": {
"id": "tpl-abc123def456",
"slug": "api-with-postgres",
"origin": "private",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"category": "apis",
"creates_stack": true,
"services": [
{ "id": "api", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "required", "conditional": false },
{ "id": "db", "kind": "database", "source_type": null, "database": "postgres", "blob_visibility": null, "ram": { "min": 256, "recommended": 256 }, "web": null, "conditional": false }
],
"ram_min_total": 512,
"created_at": "2026-10-27T14:02:00Z",
"updated_at": "2026-10-27T14:02:00Z"
}
}
Plantillas
Guardar un stack como plantilla
Guarda uno de tus stacks como plantilla privada con un servicio por miembro, eligiendo variables y archivos para cada aplicación.
POST
/
v1
/
templates
/
from-stack
/
{stack_id}
curl -X POST https://api.vertracloud.app/v1/templates/from-stack/stk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "api-with-postgres",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"description": { "pt-br": "API e banco prontos." },
"category": "apis",
"members": [
{ "resource_id": "app-abc123def456", "service_id": "api" },
{ "resource_id": "db-abc123def456", "service_id": "db" }
]
}'
{
"response": {
"id": "tpl-abc123def456",
"slug": "api-with-postgres",
"origin": "private",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"category": "apis",
"creates_stack": true,
"services": [
{ "id": "api", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "required", "conditional": false },
{ "id": "db", "kind": "database", "source_type": null, "database": "postgres", "blob_visibility": null, "ram": { "min": 256, "recommended": 256 }, "web": null, "conditional": false }
],
"ram_min_total": 512,
"created_at": "2026-10-27T14:02:00Z",
"updated_at": "2026-10-27T14:02:00Z"
}
}
Esta llamada guarda un stack como plantilla privada con una primera versión y responde
201 con la plantilla, con un servicio por cada miembro que elijas. Las variables de conexión del stack se convierten en marcadores que apuntan a los otros servicios ({{services.db.url}}, por ejemplo), y cada carpeta de Blob del stack se convierte en un servicio Blob. Un miembro que se deja fuera de la plantilla también deja fuera las variables que apuntaban a él. Las bases de datos se recrean vacías: sus datos nunca se copian.
Requiere el scope templates:write cuando se llama con una clave de API. Se aplican las reglas de plan, límite y workspace de Crear una plantilla privada, la plantilla no la verifica Vertra Cloud, y las negativas de Guardar una aplicación como plantilla valen para cada miembro que sea aplicación. Lee antes la propuesta con Revisar borrador de plantilla.
string
requerido
El ID del stack.
string
Si el stack 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[]
requerido
Lo que se guarda de cada miembro del stack, una aplicación o una base de datos.
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-stack/stk-abc123def456 \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "api-with-postgres",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"description": { "pt-br": "API e banco prontos." },
"category": "apis",
"members": [
{ "resource_id": "app-abc123def456", "service_id": "api" },
{ "resource_id": "db-abc123def456", "service_id": "db" }
]
}'
Response
El mismo objeto de plantilla que devuelve Crear una plantilla privada, con201 Created. creates_stack es true y services tiene una entrada por miembro.
{
"response": {
"id": "tpl-abc123def456",
"slug": "api-with-postgres",
"origin": "private",
"name": { "pt-br": "API com Postgres", "en": "API with Postgres" },
"category": "apis",
"creates_stack": true,
"services": [
{ "id": "api", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "required", "conditional": false },
{ "id": "db", "kind": "database", "source_type": null, "database": "postgres", "blob_visibility": null, "ram": { "min": 256, "recommended": 256 }, "web": null, "conditional": false }
],
"ram_min_total": 512,
"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).STACK_NOT_FOUND: El stack no existe o no es tuyo.APP_NOT_FOUND: Una aplicación miembro no existe.TEMPLATE_SAVE_NOT_ALLOWED: Una aplicación miembro llegó desde un enlace para compartir, o ejecuta una imagen de la plataforma (403).TEMPLATE_CLOSED: Un miembro procede de una plantilla cerrada (403).TEMPLATE_MANIFEST_INVALID: El resultado no es un manifiesto válido;details.issuesenumera los hallazgos.TEMPLATE_SECRET_IN_SOURCE: Un archivo seleccionado contiene 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_CLOSED"
}
Última modificación el 28 de octubre de 2026