Pular para o conteúdo principal
PUT
Reconstruir imagem
A requisição é multipart/form-data. A reconstrução mantém o mesmo ID da imagem e, quando dá certo, adiciona uma nova versão. Uma reconstrução nunca reinicia apps: cada app passa para a nova versão no próximo restart ou deploy que você pedir. Uma reconstrução que falha mantém a versão atual. Reconstruções não contam no limite de imagens. Planos sem imagens personalizadas não podem reconstruir, mas ainda podem apagar. Precisa do escopo images:write quando chamado com uma chave de API.
string
obrigatório
O ID da imagem.
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.
file
obrigatório
O novo contexto de build: um arquivo ZIP, de até 100 MB, com um Dockerfile na raiz.

Resposta

object
A imagem. A resposta é 202 Accepted com status: "building".

Respostas de erro

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).
  • PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: O plano não inclui imagens Docker personalizadas (403).
  • IMAGE_BUILD_IN_PROGRESS: A imagem já tem um build em execução (409).
  • DOCKERFILE_NOT_FOUND: Não existe um arquivo com o nome exato Dockerfile na raiz do contexto (400).
  • DOCKERFILE_REFUSED: O Dockerfile tem uma instrução recusada; details lista os achados (400).
  • IMAGE_CONTEXT_TOO_LARGE: O contexto de build passou de um limite: mais de 100 MB compactado, mais de 512 MB descompactado, mais de 50.000 entradas, ou um Dockerfile maior que 1 MB (413).
  • IMAGE_BUILDER_UNAVAILABLE: Nenhum host consegue construir imagens agora; tente de novo mais tarde (503).
  • INTERNAL_SERVER_ERROR: Falha inesperada (500).
Última modificação em 28 de outubro de 2026