--- title: "Changes to Update a VM" method: PUT path: "/vms/{name}" --- # Changes to Update a VM `PUT /vms/{name}` > Every recorded change to this operation, newest first. ## Timeline Changed in 21 of 42 revisions. - **2026-09-23** `08cc2c61827f`: 2 info - **2026-09-09** `68275a31b1dd`: 2 info - **2026-09-08** `cea110fafcf3`: 4 warning, 4 info - **2026-09-07** `c999f43e927d`: 1 breaking, 2 info - **2026-09-02** `8c00d644b0ad`: 2 info - **2026-09-02** `5efcfd8e9f35`: 4 info - **2026-09-01** `e3d343d89278`: 2 info - **2026-09-01** `6436dc8cb457`: 2 info - **2026-03-16** `22c44b5665e6`: 9 info - **2025-12-02** `ddc34c1a7aa4`: 3 info - **2025-11-11** `67700035bf96`: 1 info - **2025-11-11** `cd959a44c8d1`: 1 breaking - **2025-11-11** `266972c74d44`: 1 info - **2025-11-06** `eb0a5b3ac3ed`: 23 warning, 1 info - **2025-10-27** `349c4709fa60`: 4 info - **2025-10-07** `fbfcc3358a84`: 1 info - **2025-10-06** `49b3b1162c55`: 17 info - **2025-10-03** `9d74dd4eed89`: 1 info - **2025-09-26** `ece9486be282`: 1 info - **2023-10-09** `e0632c7e52ea`: 1 breaking, 3 info - **2023-01-26** `4b9547159dde`: 2 breaking, 1 info ## Changes - **2026-09-23** `08cc2c61827f`: 2 info - added the new optional request property `usbAccessories` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/usbAccessories` to the response with the `200` status - **2026-09-09** `68275a31b1dd`: 2 info - added the new optional request property `startup_script/transport` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/startup_script/transport` to the response with the `200` status - **2026-09-08** `cea110fafcf3`: 4 warning, 4 info - removed the request property `noAudio` - removed the request property `noClipboard` - removed the optional property `allOf[subschema #2: Virtual Machine Specification]/noAudio` from the response with the `200` status - removed the optional property `allOf[subschema #2: Virtual Machine Specification]/noClipboard` from the response with the `200` status - added the new optional request property `audio` - added the new optional request property `clipboard` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/audio` to the response with the `200` status - added the optional property `allOf[subschema #2: Virtual Machine Specification]/clipboard` to the response with the `200` status - **2026-09-07** `c999f43e927d`: 1 breaking, 2 info - added the new required request property `endpoints/items/protocol` - added the required property `allOf[subschema #2: Virtual Machine Specification]/endpoints/items/protocol` to the response with the `200` status - added the required property `allOf[subschema #3: Virtual Machine State]/observedEndpoints/items/protocol` to the response with the `200` status - **2026-09-02** `8c00d644b0ad`: 2 info - added the new optional request property `hostProcesses` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/hostProcesses` to the response with the `200` status - **2026-09-02** `5efcfd8e9f35`: 4 info - added the new optional request property `endpoints` - added the non-success response with the status `400` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/endpoints` to the response with the `200` status - added the optional property `allOf[subschema #3: Virtual Machine State]/observedEndpoints` to the response with the `200` status - **2026-09-01** `e3d343d89278`: 2 info - added the new optional request property `noClipboard` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/noClipboard` to the response with the `200` status - **2026-09-01** `6436dc8cb457`: 2 info - added the new optional request property `noAudio` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/noAudio` to the response with the `200` status - **2026-03-16** `22c44b5665e6`: 9 info - added the new optional request property `arch` - added the new optional request property `os` - added the new optional request property `runtime` - request property `tartName` deprecated - added the optional property `allOf[subschema #2: Virtual Machine Specification]/arch` to the response with the `200` status - added the optional property `allOf[subschema #2: Virtual Machine Specification]/localName` to the response with the `200` status - added the optional property `allOf[subschema #2: Virtual Machine Specification]/os` to the response with the `200` status - added the optional property `allOf[subschema #2: Virtual Machine Specification]/runtime` to the response with the `200` status - response property `allOf[subschema #2: Virtual Machine Specification]/tartName` deprecated - **2025-12-02** `ddc34c1a7aa4`: 3 info - added the new optional request property `powerState` - added the optional property `allOf[subschema #2: Virtual Machine Specification]/powerState` to the response with the `200` status - added the optional property `allOf[subschema #2: Virtual Machine Specification]/tartName` to the response with the `200` status - **2025-11-11** `67700035bf96`: 1 info - the response optional property `allOf[subschema #1: Virtual Machine Metadata]/name` became not read-only for the status `200` - **2025-11-11** `cd959a44c8d1`: 1 breaking - added required request body - **2025-11-11** `266972c74d44`: 1 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/suspendable` to the response with the `200` status - **2025-11-06** `eb0a5b3ac3ed`: 23 warning, 1 info - removed the optional property `cpu` from the response with the `200` status - removed the optional property `diskSize` from the response with the `200` status - removed the optional property `headless` from the response with the `200` status - removed the optional property `hostDirs` from the response with the `200` status - removed the optional property `image` from the response with the `200` status - removed the optional property `imagePullPolicy` from the response with the `200` status - removed the optional property `labels` from the response with the `200` status - removed the optional property `memory` from the response with the `200` status - removed the optional property `name` from the response with the `200` status - removed the optional property `nested` from the response with the `200` status - removed the optional property `net-bridged` from the response with the `200` status - removed the optional property `net-softnet` from the response with the `200` status - removed the optional property `netSoftnet` from the response with the `200` status - removed the optional property `netSoftnetAllow` from the response with the `200` status - removed the optional property `netSoftnetBlock` from the response with the `200` status - removed the optional property `password` from the response with the `200` status - removed the optional property `resources` from the response with the `200` status - removed the optional property `restart_policy` from the response with the `200` status - removed the optional property `startup_script` from the response with the `200` status - removed the optional property `status` from the response with the `200` status - removed the optional property `status_message` from the response with the `200` status - removed the optional property `username` from the response with the `200` status - removed the optional property `worker` from the response with the `200` status - added `#/components/schemas/VMMeta, #/components/schemas/VMSpec, #/components/schemas/VMState` to the response body `allOf` list for the response status `200` - **2025-10-27** `349c4709fa60`: 4 info - added the optional property `netSoftnet` to the response with the `200` status - added the optional property `netSoftnetAllow` to the response with the `200` status - added the optional property `netSoftnetBlock` to the response with the `200` status - response property `net-softnet` deprecated - **2025-10-07** `fbfcc3358a84`: 1 info - added the optional property `startup_script` to the response with the `200` status - **2025-10-06** `49b3b1162c55`: 17 info - added the optional property `cpu` to the response with the `200` status - added the optional property `diskSize` to the response with the `200` status - added the optional property `headless` to the response with the `200` status - added the optional property `image` to the response with the `200` status - added the optional property `imagePullPolicy` to the response with the `200` status - added the optional property `labels` to the response with the `200` status - added the optional property `memory` to the response with the `200` status - added the optional property `net-bridged` to the response with the `200` status - added the optional property `net-softnet` to the response with the `200` status - added the optional property `password` to the response with the `200` status - added the optional property `restart_policy` to the response with the `200` status - added the optional property `status` to the response with the `200` status - added the optional property `status_message` to the response with the `200` status - added the optional property `username` to the response with the `200` status - added the optional property `worker` to the response with the `200` status - the response optional property `name` became read-only for the status `200` - the `nested` response's property default value `false` was added for the status `200` - **2025-10-03** `9d74dd4eed89`: 1 info - added the new optional `query` request parameter `watch` to all path's operations - **2025-09-26** `ece9486be282`: 1 info - added the optional property `nested` to the response with the `200` status - **2023-10-09** `e0632c7e52ea`: 1 breaking, 3 info - the response's body type changed from no type to `object` for status `200` - added the optional property `hostDirs` to the response with the `200` status - added the optional property `name` to the response with the `200` status - added the optional property `resources` to the response with the `200` status - **2023-01-26** `4b9547159dde`: 2 breaking, 1 info - removed the request body - the response's body type changed from `object` to no type for status `200` - removed `#/components/schemas/VMMeta, #/components/schemas/VMSpec, #/components/schemas/VMState` from the response body `allOf` list for the response status `200` --- [Operation](https://skmtc.dev/openai/apis/orchard/docs/vms/:name/put.md) - [API](https://skmtc.dev/openai/apis/orchard.md) - [Page](https://skmtc.dev/openai/apis/orchard/changes/vms/:name/put)