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

# Obtener una imagen

> Obtiene una imagen Docker personalizada por su ID, con su versión actual y las aplicaciones que la usan.

Necesita el ámbito `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úan sobre una imagen que no les pertenece.

### Respuesta

**response** `object`

La imagen.

**Mostrar objeto**

**id** `string`

El ID de la imagen.

**name** `string`

El nombre de la imagen.

**description** `string | null`

La descripción de la imagen (texto libre, de hasta 128 caracteres), o `null` cuando no tiene.

**owner** `string`

`account` para tus propias imágenes, `system` para las imágenes que proporciona la plataforma (estas no se pueden modificar ni eliminar).

**kind** `string`

`own` para una imagen que construiste tú, o `template_copy` para la copia de la imagen de una plantilla que [usar una plantilla](https://docs.vertracloud.app/es-es/templates/use/using-a-template.md) puso en tu cuenta. Una copia ocupa una ranura de imagen y solo se puede usar a través de su plantilla.

**origin** `object | null`

Para una `template_copy`, la plantilla de la que procede: `template_id`, `template_name` (por idioma) y `author_display` (`null` para una plantilla de la plataforma). `null` para tus propias imágenes.

**status** `string`

Estado del último build: `building`, `success` o `failed`. Un rebuild fallido no cambia la versión actual: las aplicaciones siguen ejecutando la última versión correcta.

**error** `string | null`

Motivo legible del último build fallido, o `null`.

**digest** `string | null`

Digest (`sha256:...`) de la versión actual, o `null` mientras ningún build haya tenido éxito.

**uncompressed\_bytes** `integer | null`

Tamaño de la versión actual, sin comprimir, en bytes.

**layer\_count** `integer | null`

Número de capas de la versión actual.

**suggested\_port** `integer | null`

Puerto sugerido para una aplicación nueva sobre esta imagen: el primer `EXPOSE` del `Dockerfile` del último contexto de build, o `80`. `null` en una imagen creada antes de que existiera este campo.

**apps** `object[]`

Las aplicaciones creadas a partir de esta imagen. Cada una tiene `id`, `name`, `version_id` (la versión de la imagen que ejecuta, o `null`) y `outdated` (`true` cuando la imagen tiene una versión más reciente; la aplicación pasa a ella en el siguiente reinicio o despliegue que pidas).

**github** `object | null`

El repositorio y la rama de GitHub vinculados (`repository` como `owner/name`, `branch`), o `null` cuando la imagen no está vinculada.

**current\_version\_id** `string | null`

La versión actual de la imagen, o `null` mientras ningún build haya tenido éxito.

**created\_at** `string`

Cuándo se creó la imagen.

**updated\_at** `string`

Cuándo se actualizó por última vez la imagen.

```json Response theme={null}
{
  "response": {
    "id": "img-abc123def456",
    "name": "my-api",
    "description": "Node 22 with our base packages",
    "owner": "account",
    "status": "success",
    "error": null,
    "digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
    "uncompressed_bytes": 187432960,
    "layer_count": 9,
    "suggested_port": 3000,
    "apps": [
      {
        "id": "app-abc123def456",
        "name": "my-api-prod",
        "version_id": "imgv-111aaa222bbb",
        "outdated": false
      }
    ],
    "github": null,
    "current_version_id": "imgv-111aaa222bbb",
    "created_at": "2026-10-23T14:02:00Z",
    "updated_at": "2026-10-23T14:09:00Z"
  }
}
```

### Respuestas de error

**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 ámbito requerido (`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.