> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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ó.

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](https://docs.vertracloud.app/es-es/api-reference/endpoint/templates/get.md): 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 `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.

**template\_id** `string` *required*

El ID de la plantilla o su slug.

**workspace\_id** `string`

El workspace de una plantilla privada. Hace falta para resolver una plantilla del workspace por slug.

Puedes desplegar una versión anterior solo cuando la plantilla lo permite; ver `version` en [Desplegar plantilla](https://docs.vertracloud.app/es-es/api-reference/endpoint/templates/deploy.md).

### Respuesta

**response** `object[]`

Un array de versiones.

**Mostrar objeto**

**id** `string`

El ID de la versión.

**version** `string`

La versión semántica, como `1.2.0`.

**security** `boolean`

`true` para una release de seguridad. Los propietarios de aplicaciones en una versión anterior reciben aviso.

**created\_at** `string`

Cuándo se publicó la versión.

**changelog** `object | null`

Qué cambió, como texto por idioma (`pt-br`, `en`, `es`), o `null`.

**manifest** `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](https://docs.vertracloud.app/es-es/templates/create/manifest-reference.md). Los valores de las variables ocultas nunca se incluyen. Es `null` cuando la plantilla está cerrada y tú no eres su propietario.

```bash cURL theme={null}
curl https://api.vertracloud.app/v1/templates/discord-bot-js/versions \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

```json Response theme={null}
{
  "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

**code** `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 scope `templates:read` (`403`).
* `TEMPLATE_NOT_FOUND`: La plantilla no existe, fue eliminada o no es visible para ti (`404`).
* `WORKSPACE_NOT_FOUND`: El workspace de `workspace_id` no existe o no formas parte de él (`404`).
* `RATE_LIMIT_EXCEEDED`: Demasiadas peticiones (`429`).
* `INTERNAL_SERVER_ERROR`: Fallo inesperado (`500`).

```json Error Response theme={null}
{
  "code": "TEMPLATE_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.