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

# Logs de build da imagem

> Transmite o log de build de uma imagem como um stream de eventos de texto.

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

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

O ID da imagem.

**version\_id** `string`

A versão cujo log de build será lido. Ausente: o build mais recente.

**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

A resposta é um stream de **Server-Sent Events** (`text/event-stream`), não JSON. Primeiro ele repete o log que já tinha saído e depois acompanha o build ao vivo, com heartbeats de keep-alive. Cada evento `log` traz uma linha do log de build como texto simples. Até 2 streams por imagem podem estar abertos ao mesmo tempo. Depois que o build termina, o log do build mais recente e de cada versão continua disponível.

```text Response theme={null}
event: log
data: Step 1/6 : FROM node:22-slim

event: log
data: Step 2/6 : WORKDIR /srv
```

### 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`).
* `IMAGE_VERSION_NOT_FOUND`: A imagem não tem nenhuma versão com esse `version_id` (`404`).
* `INTERNAL_SERVER_ERROR`: Falha inesperada (`500`).

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


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