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"
}
}
Templates
Salvar um app como template
Salva um dos seus apps como template privado, escolhendo quais variáveis viram perguntas e quais arquivos entram.
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 chamada salva um app como template privado com uma primeira versão e responde
201 com o template. Os valores das variáveis nunca são copiados, a menos que você escolha keep para uma variável que não parece uma credencial. Chame primeiro Revisar rascunho do template para ver o que a plataforma propõe.
Precisa do escopo templates:write quando chamado com uma chave de API. Valem as mesmas regras de plano, limite de 5 templates e workspace de Criar template privado, e o template não é verificado pela Vertra Cloud. Um app que veio de um link de compartilhamento não pode ser salvo (TEMPLATE_SAVE_NOT_ALLOWED), nem um app de um template fechado (TEMPLATE_CLOSED). Um app que executa uma imagem da plataforma também não pode ser salvo.
string
obrigatório
O ID do app.
string
Se o app 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. Campos ausentes assumem o padrão.
object
obrigatório
O que salvar do app.
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-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" }
]
}
}'
Resposta
O mesmo objeto de template retornado por Criar template privado, com201 Created: id, slug, origin (private), name, description, category, tags, current_version, services, inputs, permissions, outputs e os outros campos listados lá.
{
"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"
}
}
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).APP_NOT_FOUND: O app não existe ou não é seu.TEMPLATE_SAVE_NOT_ALLOWED: O app veio de um link de compartilhamento, ou executa uma imagem da plataforma (403).TEMPLATE_CLOSED: O app vem de um template fechado (403).TEMPLATE_MANIFEST_INVALID: O resultado não é um manifesto válido, ou uma variávelkeeptem algo que parece uma credencial;details.issueslista os achados.TEMPLATE_SECRET_IN_SOURCE: Um arquivo selecionado de/apptem 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_SAVE_NOT_ALLOWED"
}
Última modificação em 28 de outubro de 2026