Saltar al contenido principal
PUT
Reconstruir imagen
La petición es multipart/form-data. La reconstrucción mantiene el mismo ID de imagen y, si tiene éxito, añade una nueva versión. Una reconstrucción nunca reinicia las aplicaciones: cada aplicación pasa a la nueva versión en el siguiente reinicio o despliegue que pidas. Una reconstrucción fallida conserva la versión actual. Las reconstrucciones no cuentan contra el límite de imágenes. Los planes sin imágenes personalizadas no pueden reconstruir, pero sí eliminar. 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. Es obligatorio para los miembros del workspace que actúen sobre una imagen que no les pertenece.
file
requerido
El nuevo contexto de build: un archivo ZIP, de hasta 100 MB, con un Dockerfile en su raíz.

Response

object
La imagen. La respuesta es 202 Accepted con status: "building".

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).
  • IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).
  • PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES: El plan no incluye imágenes Docker personalizadas (403).
  • IMAGE_BUILD_IN_PROGRESS: La imagen ya tiene un build en curso (409).
  • DOCKERFILE_NOT_FOUND: No hay ningún archivo llamado exactamente Dockerfile en la raíz del contexto (400).
  • DOCKERFILE_REFUSED: El Dockerfile tiene una instrucción no admitida; details enumera los hallazgos (400).
  • IMAGE_CONTEXT_TOO_LARGE: El contexto de build supera un límite: más de 100 MB comprimido, más de 512 MB sin comprimir, más de 50.000 entradas, o un Dockerfile de más de 1 MB (413).
  • IMAGE_BUILDER_UNAVAILABLE: Ningún host puede construir imágenes en este momento; inténtalo más tarde (503).
  • INTERNAL_SERVER_ERROR: Fallo inesperado (500).
Última modificación el 28 de octubre de 2026