curl https://api.vertracloud.app/v1/templates/discord-bot-js/versions \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": [
{
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.1.0",
"security": true,
"created_at": "2026-10-28T10:30:00Z",
"changelog": { "en": "Updated discord.js to a release with a security fix." },
"manifest": {
"id": "discord-bot-js",
"version": "1.1.0",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)" },
"description": { "pt-br": "Bot de Discord com discord.js e o comando /ping." },
"category": "bots",
"inputs": [{ "id": "discord_token", "type": "secret", "required": true, "label": { "pt-br": "Token do bot", "en": "Bot token" } }],
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"start": "node index.js",
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"env": { "DISCORD_TOKEN": "{{inputs.discord_token}}" }
}
}
}
},
{
"id": "b4f81c36-0a5e-47d2-b1c9-6e3a7d90f2a8",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z",
"changelog": null,
"manifest": { "id": "discord-bot-js", "version": "1.0.0", "category": "bots", "services": { "app": { "source": { "type": "code", "path": "src" }, "ram": { "min": 256, "recommended": 256 } } } }
}
]
}
Templates
Listar versões do template
Lista as versões publicadas de um template, da mais nova para a mais antiga, com changelog e manifesto de cada uma, para escolher ou ver o que mudou.
GET
/
v1
/
templates
/
{template_id}
/
versions
curl https://api.vertracloud.app/v1/templates/discord-bot-js/versions \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": [
{
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.1.0",
"security": true,
"created_at": "2026-10-28T10:30:00Z",
"changelog": { "en": "Updated discord.js to a release with a security fix." },
"manifest": {
"id": "discord-bot-js",
"version": "1.1.0",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)" },
"description": { "pt-br": "Bot de Discord com discord.js e o comando /ping." },
"category": "bots",
"inputs": [{ "id": "discord_token", "type": "secret", "required": true, "label": { "pt-br": "Token do bot", "en": "Bot token" } }],
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"start": "node index.js",
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"env": { "DISCORD_TOKEN": "{{inputs.discord_token}}" }
}
}
}
},
{
"id": "b4f81c36-0a5e-47d2-b1c9-6e3a7d90f2a8",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z",
"changelog": null,
"manifest": { "id": "discord-bot-js", "version": "1.0.0", "category": "bots", "services": { "app": { "source": { "type": "code", "path": "src" }, "ram": { "min": 256, "recommended": 256 } } } }
}
]
}
Retorna as versões prontas de um template, da mais nova para a mais antiga, até 100. Versões nunca mudam depois de publicadas. A visibilidade é a de Obter template: templates públicos não precisam de autenticação, um privado é visível só para o dono ou para leitores do workspace, e qualquer outra pessoa recebe
Você só pode fazer deploy de uma versão anterior quando o template permite; veja
TEMPLATE_NOT_FOUND. Com uma chave de API, o escopo é templates:read. As leituras são limitadas a 60 requisições por minuto por cliente.
string
obrigatório
O ID do template ou o seu slug.
string
O workspace de um template privado. Necessário para resolver um template de workspace pelo slug.
version em Deploy de template.
Resposta
object[]
Um array de versões.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID da versão.
string
A versão semântica, como
1.2.0.boolean
true para uma release de segurança. Donos de aplicações em uma versão anterior são avisados.string
Quando a versão foi publicada.
object | null
O que mudou, como um texto por idioma (
pt-br, en, es), ou null.object | null
O manifesto da versão:
id, version, name, description, category, tags, inputs, services, permissions, outputs e os outros campos descritos na referência do manifesto. Valores de variáveis ocultas nunca são incluídos. Fica null quando o template está fechado e você não é o dono.curl https://api.vertracloud.app/v1/templates/discord-bot-js/versions \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": [
{
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.1.0",
"security": true,
"created_at": "2026-10-28T10:30:00Z",
"changelog": { "en": "Updated discord.js to a release with a security fix." },
"manifest": {
"id": "discord-bot-js",
"version": "1.1.0",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)" },
"description": { "pt-br": "Bot de Discord com discord.js e o comando /ping." },
"category": "bots",
"inputs": [{ "id": "discord_token", "type": "secret", "required": true, "label": { "pt-br": "Token do bot", "en": "Bot token" } }],
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"start": "node index.js",
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"env": { "DISCORD_TOKEN": "{{inputs.discord_token}}" }
}
}
}
},
{
"id": "b4f81c36-0a5e-47d2-b1c9-6e3a7d90f2a8",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z",
"changelog": null,
"manifest": { "id": "discord-bot-js", "version": "1.0.0", "category": "bots", "services": { "app": { "source": { "type": "code", "path": "src" }, "ram": { "min": 256, "recommended": 256 } } } }
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
VALIDATION_ERROR: Um parâmetro não é válido (400).API_KEY_SCOPE_DENIED: A chave de API não tem o escopotemplates:read(403).TEMPLATE_NOT_FOUND: O template não existe, foi removido ou não é visível para você (404).WORKSPACE_NOT_FOUND: O workspace emworkspace_idnão existe ou você não faz parte dele (404).RATE_LIMIT_EXCEEDED: Requisições demais (429).INTERNAL_SERVER_ERROR: Falha inesperada (500).
{
"code": "TEMPLATE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026