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

# Baixar o contexto da imagem

> Retorna uma URL temporária para baixar o contexto de build atual de uma imagem.

O contexto atual é o contexto de build completo do último build bem-sucedido, sem os arquivos `.env*`. Ele também é a base dos [commits](https://docs.vertracloud.app/pt-br/guides/custom-docker-images.md#commit-on-top-of-the-current-context).

Exige o escopo `images:read` quando chamada 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 atuam sobre uma imagem que não lhes pertence.

### Resposta

**response** `object`

**Mostrar objeto**

**url** `string`

Uma URL temporária para baixar o contexto de build atual como um arquivo ZIP.

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

### 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 exigido (`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.