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

> Lista las versiones de una imagen, de la más reciente a la más antigua. Cada build exitoso es una nueva versión de la misma imagen.

Requiere el scope `images:read` cuando se llama con una clave de API.

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

El ID de la imagen.

**workspace\_id** `string`

Si la imagen pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una imagen que no les pertenece.

### Response

**response** `array`

Un array de versiones, de la más reciente a la más antigua.

**Mostrar objeto**

**id** `string`

El ID de la versión. Úsalo como `version_id` para leer el log de build de esa versión.

**digest** `string`

Digest (`sha256:...`) de la versión.

**source** `string`

Lo que disparó el build: `upload` (se subió un contexto completo), `commit` (archivos confirmados sobre el contexto actual) o `github` (un push a la rama vinculada).

**message** `string | null`

El mensaje enviado con la subida o el commit, o `null`.

**created\_at** `string`

Cuándo se construyó la versión.

**in\_use** `boolean`

`true` cuando al menos una aplicación ejecuta esta versión.

```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]
>
> Una aplicación conserva hasta 30 releases durante 30 días en los planes Enterprise, y cada release apunta a una versión de la imagen. Para volver atrás una aplicación, usa [Revertir aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/releases/rollback.md). Una versión solo se elimina cuando ningún release de ninguna aplicación la usa y no es la actual.

### Error Responses

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `API_KEY_SCOPE_DENIED`: La clave de API no tiene el scope necesario (`403`).
* `IMAGE_NOT_FOUND`: La imagen no existe o no puedes acceder a ella (`404`).
* `INTERNAL_SERVER_ERROR`: Fallo inesperado (`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.