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

# Descargar el contexto de una imagen

> Devuelve una URL de descarga temporal del contexto de build actual de una imagen.

El contexto actual es el contexto de build completo del último build correcto, sin los archivos `.env*`. También es la base para los [commits](https://docs.vertracloud.app/es-es/guides/custom-docker-images.md#commit-on-top-of-the-current-context).

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`

**Mostrar objeto**

**url** `string`

Una URL temporal para descargar el contexto de build actual como archivo ZIP.

```json Response theme={null}
{
  "response": {
    "url": "https://api.vertracloud.app/..."
  }
}
```

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