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

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

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

O ID do template ou o seu slug.

**workspace\_id** `string`

O workspace de um template privado. Necessário para resolver um template de workspace pelo slug.

Você só pode fazer deploy de uma versão anterior quando o template permite; veja `version` em [Deploy de template](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/deploy.md).

### Resposta

**response** `object[]`

Um array de versões.

**Mostrar objeto**

**id** `string`

O ID da versão.

**version** `string`

A versão semântica, como `1.2.0`.

**security** `boolean`

`true` para uma release de segurança. Donos de aplicações em uma versão anterior são avisados.

**created\_at** `string`

Quando a versão foi publicada.

**changelog** `object | null`

O que mudou, como um texto por idioma (`pt-br`, `en`, `es`), ou `null`.

**manifest** `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](https://docs.vertracloud.app/pt-br/templates/create/manifest-reference.md). Valores de variáveis ocultas nunca são incluídos. Fica `null` quando o template está fechado e você não é o dono.

```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 } } } }
    }
  ]
}
```

### Respostas de erro

**code** `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 escopo `templates: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 em `workspace_id` não existe ou você não faz parte dele (`404`).
* `RATE_LIMIT_EXCEEDED`: Requisições demais (`429`).
* `INTERNAL_SERVER_ERROR`: Falha inesperada (`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.