> ## 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 da imagem

> Lista as versões de uma imagem, da mais nova para a mais antiga. Cada build bem-sucedido é uma nova versão da mesma imagem.

Precisa do escopo `images:read` quando chamado com uma chave de API.

**image\_id** `string` *required*

O ID da imagem.

**workspace\_id** `string`

Se a imagem pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que agem sobre uma imagem que não é deles.

### Resposta

**response** `array`

Um array de versões, da mais nova para a mais antiga.

**Mostrar objeto**

**id** `string`

O ID da versão. Use-o como `version_id` para ler o log de build dessa versão.

**digest** `string`

Digest (`sha256:...`) da versão.

**source** `string`

O que disparou o build: `upload` (um contexto completo enviado), `commit` (arquivos commitados sobre o contexto atual) ou `github` (um push na branch vinculada).

**message** `string | null`

A mensagem enviada com o upload ou o commit, ou `null`.

**created\_at** `string`

Quando a versão foi construída.

**in\_use** `boolean`

`true` quando pelo menos um app executa esta versão.

```json Response theme={null}
{
  "response": [
    {
      "id": "imgv-111aaa222bbb",
      "digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
      "source": "upload",
      "message": "first build",
      "created_at": "2026-10-23T14:09:00Z",
      "in_use": true
    }
  ]
}
```

> [!NOTE]
>
> Um app mantém até 30 releases por 30 dias nos planos Enterprise, e cada release aponta para uma versão da imagem. Faça rollback de um app com [Fazer rollback do app](https://docs.vertracloud.app/pt-br/api-reference/endpoint/apps/releases/rollback.md). Uma versão só é removida quando nenhuma release de nenhum app a usa e ela não é a atual.

### Respostas de erro

**code** `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 escopo necessário (`403`).
* `IMAGE_NOT_FOUND`: A imagem não existe ou você não tem acesso a ela (`404`).
* `INTERNAL_SERVER_ERROR`: Falha inesperada (`500`).

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


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