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 } } } }
}
]
}
Plantillas
Listar versiones de la plantilla
Lista las versiones publicadas de una plantilla, de la más nueva a la más antigua, con su changelog y manifiesto, para elegir una o ver qué cambió.
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 } } } }
}
]
}
Devuelve las versiones listas de una plantilla, de la más nueva a la más antigua, hasta 100. Las versiones nunca cambian después de publicarse. La visibilidad es la de Obtener plantilla: las plantillas públicas no necesitan autenticación, una privada solo es visible para su propietario o para los lectores del workspace, y cualquier otro recibe
Puedes desplegar una versión anterior solo cuando la plantilla lo permite; ver
TEMPLATE_NOT_FOUND. Con una clave de API el scope es templates:read. Las lecturas están limitadas a 60 peticiones por minuto y por cliente.
string
requerido
El ID de la plantilla o su slug.
string
El workspace de una plantilla privada. Hace falta para resolver una plantilla del workspace por slug.
version en Desplegar plantilla.
Respuesta
object[]
Un array de versiones.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la versión.
string
La versión semántica, como
1.2.0.boolean
true para una release de seguridad. Los propietarios de aplicaciones en una versión anterior reciben aviso.string
Cuándo se publicó la versión.
object | null
Qué cambió, como texto por idioma (
pt-br, en, es), o null.object | null
El manifiesto de la versión:
id, version, name, description, category, tags, inputs, services, permissions, outputs y los demás campos descritos en la referencia del manifiesto. Los valores de las variables ocultas nunca se incluyen. Es null cuando la plantilla está cerrada y tú no eres su propietario.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 } } } }
}
]
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
VALIDATION_ERROR: Un parámetro no es válido (400).API_KEY_SCOPE_DENIED: La clave de API no tiene el scopetemplates:read(403).TEMPLATE_NOT_FOUND: La plantilla no existe, fue eliminada o no es visible para ti (404).WORKSPACE_NOT_FOUND: El workspace deworkspace_idno existe o no formas parte de él (404).RATE_LIMIT_EXCEEDED: Demasiadas peticiones (429).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "TEMPLATE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026