---
title: "Update a machine image"
method: PATCH
path: "/project/{project_id}/location/{location}/machine-image/{machine_image_reference}"
tags: ["Machine Image"]
---

# Update a machine image

`PATCH /project/{project_id}/location/{location}/machine-image/{machine_image_reference}`

## Path parameters

- `machine_image_reference` string, required — Resource ID or name

## Request body

- object
  - `latest_version` string, required — Version label to set as latest

## Response `200`

A machine image

- MachineImage
  - `id` string, required — ID of the machine image
  - `name` string, required — Name of the machine image
  - `location` string, required — Location of the machine image
  - `arch` 'x64' | 'arm64', required — Architecture
  - `latest_version` string, nullable — Latest version label
  - `created_at` string, date-time, required — Creation timestamp

## Other responses

- `default` — An error response

## Changes

> 59 revisions in range; 7 could not be searched.

- **2026-06-09** `d8126ac0f7cf` — 1 breaking
  - the request property `latest_version` became not nullable
- **2026-05-29** `5bb8dcd4ce12` — 7 info
  - removed `#/components/schemas/MachineImage, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `latest_version` to the response with the `200` status
  - added the required property `arch` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - …3 more
- **2026-04-30** `b6ddb6f4553f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ubicloud/apis/clover-api/changes/project/:project_id/location/:location/machine-image/:machine_image_reference/patch.md)

---

[API](https://skmtc.dev/ubicloud/apis/clover-api.md) · [All operations](https://skmtc.dev/ubicloud/apis/clover-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ubicloud/clover-api/revisions/ae229e5ccaee/schema)