Pular para o conteúdo principal
PUT
Vincular imagem ao GitHub
O repositório precisa estar em uma das suas instalações do GitHub App. Um repositório público fora delas pode ser construído uma vez com Criar imagem, mas só pode ser vinculado depois que você instalar o GitHub App nele. Um push na branch vinculada reconstrói a imagem exatamente como uma reconstrução manual, com o repositório nessa branch como contexto de build. Pushes são ignorados enquanto um build da imagem já estiver em execução. Reconstruções vindas do GitHub nunca reiniciam apps. Só o dono da imagem pode vinculá-la. Em um workspace, um membro recebe 403 mesmo com permissão para gerenciar os apps do workspace, porque o vínculo usa as instalações do GitHub App do dono. 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.
string
obrigatório
O repositório, no formato owner/name.
string
A branch que dispara a reconstrução. Opcional: sem ela, usa-se a branch padrão do repositório (main, master ou a que o repositório definir).

Resposta

object
A imagem.

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).
  • ACCESS_DENIED: Você não é o dono da imagem, ou ela é uma imagem da plataforma (403).
  • IMAGE_NOT_FOUND: A imagem não existe ou você não tem acesso a ela (404).
  • VALIDATION_ERROR: O corpo falhou na validação, por exemplo um repository que não está no formato owner/name (400).
  • INSTALLATION_NOT_FOUND: O repositório não está em nenhuma das suas instalações do GitHub App (404).
  • REPO_ALREADY_LINKED: O repositório já está vinculado a outra imagem ou app (409).
  • FETCH_ZIP_ERROR: O GitHub não pôde ser acessado, ou estava limitando requisições enquanto o repositório era verificado (502). Tente de novo em alguns minutos.
  • PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: O plano não inclui imagens Docker personalizadas (403).
  • INTERNAL_SERVER_ERROR: Falha inesperada (500).
Última modificação em 28 de outubro de 2026