Saltar al contenido principal
PATCH
Actualizar imagen
Cambia el name y/o la description de la imagen. No se construye ni se reinicia nada: la imagen conserva su ID y sus versiones, y las aplicaciones creadas a partir de ella siguen ejecutándose. Envía solo los campos que quieras cambiar; se necesita al menos uno. Las imágenes de la plataforma (owner: "system") no se pueden modificar. Requiere el scope images:write cuando se llama con una clave de API. En un workspace, necesitas permiso para gestionar las aplicaciones del workspace.
string
requerido
El ID de la imagen.
string
Si la imagen pertenece a un workspace, el ID del workspace.
string
El nuevo nombre: de 1 a 50 caracteres, único entre las imágenes del propietario. Enviar el nombre actual no es un error. Un nombre que ya usa otra de tus imágenes falla con VALIDATION_ERROR, con path igual a name.
string | null
La nueva descripción, de hasta 128 caracteres (texto libre). null o una cadena vacía la elimina.

Response

object
La imagen actualizada.

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).
  • VALIDATION_ERROR: El cuerpo está vacío, el nombre no tiene de 1 a 50 caracteres, el nombre ya lo usa otra de tus imágenes (path es name), la descripción supera los 128 caracteres, o el nombre o la descripción contienen caracteres de control (400).
  • ACCESS_DENIED: La imagen es una imagen de la plataforma, que no se puede modificar (403).
  • IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).
  • INTERNAL_SERVER_ERROR: Fallo inesperado (500).
Última modificación el 28 de octubre de 2026