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"
}
}
Templates
Salvar uma stack como template
Salva uma das suas stacks como template privado, com um serviço por membro, escolhendo variáveis e arquivos de cada app.
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 chamada salva uma stack como template privado com uma primeira versão e responde
201 com o template, com um serviço por membro que você escolher. As variáveis de conexão da stack viram placeholders que apontam para os outros serviços ({{services.db.url}}, por exemplo), e cada pasta do Blob da stack vira um serviço Blob. Um membro deixado de fora do template também deixa de fora as variáveis que apontavam para ele. Os bancos de dados são recriados vazios: os dados deles nunca são copiados.
Precisa do escopo templates:write quando chamado com uma chave de API. Valem o plano, o limite e as regras de workspace de Criar template privado, o template não é verificado pela Vertra Cloud, e as recusas de Criar template a partir de app valem para cada membro que é app. Leia antes a proposta com Revisar rascunho do template.
string
obrigatório
O ID da stack.
string
Se a stack pertencer a um workspace, o ID do workspace.
string
obrigatório
O slug do template, com letras minúsculas, números e hífens.
object
obrigatório
O nome por idioma:
pt-br (obrigatório), en e es, de até 50 caracteres cada.object
obrigatório
A descrição por idioma, no mesmo formato de
name, de até 128 caracteres cada.string
obrigatório
automation, ai-agents, bots, apis, cms, monitoring, starters, databases ou other.string[]
Até 10 tags.
string
A primeira versão, como versão semântica. Padrão
1.0.0.object
O que os usuários do template podem fazer, como nas permissões do manifesto.
object[]
obrigatório
O que salvar de cada membro da stack, um app ou um banco de dados.
Mostrar Objeto `member`
Mostrar Objeto `member`
string
obrigatório
O ID do app ou do banco de dados a salvar.
string
obrigatório
O id que o serviço recebe no manifesto.
object[]
Uma revisão por variável de um app. Uma variável sem revisão fica de fora do template. Cada revisão tem:
key: o nome da variável.mode:question(vira uma pergunta que o usuário responde; o valor não é copiado),keep(o valor é copiado; recusado quando parece uma credencial),generate(vira um segredo que a plataforma gera para cada usuário, comgeneratedefinido comorandom:<n>ouuuid),hidden(copiado, mas oculto de quem usa o template; o valor fica fora de vista de quem usa o template) ouomit(fica de fora).labelehelp: textos por idioma (pt-br,en,es), usados porquestionegenerate.generate: como o segredo é gerado,random:<n>ouuuid.
string[]
Os caminhos de
/app do app que entram no template, para apps com código. Sem ele, entra tudo, exceto o que o rascunho deixa sem selecionar. Arquivos .env*, a pasta da plataforma e as pastas de dependências nunca podem ser incluídos.object
A memória do serviço em MB:
min, recommended e max opcional.string
O workspace que será dono do template. Sem ele, o template é seu.
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" }
]
}'
Resposta
O mesmo objeto de template retornado por Criar template privado, com201 Created. creates_stack é true e services tem uma entrada por membro.
{
"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"
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
API_KEY_SCOPE_DENIED: A chave de API não tem o escopotemplates:write(403).STACK_NOT_FOUND: A stack não existe ou não é sua.APP_NOT_FOUND: Um app membro não existe.TEMPLATE_SAVE_NOT_ALLOWED: Um app membro veio de um link de compartilhamento, ou executa uma imagem da plataforma (403).TEMPLATE_CLOSED: Um membro vem de um template fechado (403).TEMPLATE_MANIFEST_INVALID: O resultado não é um manifesto válido;details.issueslista os achados.TEMPLATE_SECRET_IN_SOURCE: Um arquivo selecionado tem um segredo;details.fileslista os caminhos (400).TEMPLATE_SLUG_TAKEN: O slug já está em uso entre os seus templates ou é reservado.TEMPLATE_PRIVATE_LIMIT_REACHED: A conta já tem 5 templates privados.PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: O plano não pode criar templates.WORKSPACE_OWNER_ONLY: Só o dono do workspace salva templates nele.
{
"code": "TEMPLATE_CLOSED"
}
Última modificação em 28 de outubro de 2026