Saltar al contenido principal
PUT
Vincular imagen a GitHub
El repositorio debe estar en una de tus instalaciones de la GitHub App. Un repositorio público que esté fuera de ellas puede compilarse una vez con Crear imagen, pero solo puede vincularse después de instalar la GitHub App en él. Un push a la rama vinculada reconstruye la imagen exactamente igual que una reconstrucción manual, con el repositorio en esa rama como contexto de build. Los pushes se omiten mientras ya haya un build de la imagen en curso. Las reconstrucciones desde GitHub nunca reinician las aplicaciones. Solo el propietario de la imagen puede vincularla. En un workspace, un miembro recibe 403 aunque tenga permiso para gestionar las aplicaciones del workspace, porque el vínculo usa las instalaciones de GitHub App del propietario. Requiere el scope images:write cuando se llama con una clave de API.
string
requerido
El ID de la imagen.
string
Si la imagen pertenece a un workspace, el ID del workspace.
string
requerido
El repositorio, como owner/name.
string
La rama que dispara la reconstrucción. Es opcional: si no se indica, se usa la rama por defecto del repositorio (main, master o la que tenga configurada el repositorio).

Response

object
La imagen.

Error Responses

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 scope necesario (403).
  • ACCESS_DENIED: No eres el propietario de la imagen, o es una imagen de la plataforma (403).
  • IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).
  • VALIDATION_ERROR: El cuerpo no superó la validación, por ejemplo un repository que no es owner/name (400).
  • INSTALLATION_NOT_FOUND: El repositorio no está en ninguna de tus instalaciones de GitHub App (404).
  • REPO_ALREADY_LINKED: El repositorio ya está vinculado a otra imagen o aplicación (409).
  • FETCH_ZIP_ERROR: No se pudo contactar con GitHub, o GitHub estaba limitando peticiones mientras se comprobaba el repositorio (502). Inténtalo de nuevo en unos minutos.
  • PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: El plan no incluye imágenes Docker personalizadas (403).
  • INTERNAL_SERVER_ERROR: Fallo inesperado (500).
Última modificación el 28 de octubre de 2026