--- title: "Changes to Retrieve a VM" method: GET path: "/vms/{name}" --- # Changes to Retrieve a VM `GET /vms/{name}` > Every recorded change to this operation, newest first. ## Timeline Changed in 20 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`: 4 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`: 10 info - **2025-12-02** `ddc34c1a7aa4`: 4 info - **2025-11-11** `67700035bf96`: 2 info - **2025-11-11** `266972c74d44`: 2 info - **2025-11-06** `eb0a5b3ac3ed`: 46 warning, 2 info - **2025-10-27** `349c4709fa60`: 8 info - **2025-10-07** `fbfcc3358a84`: 2 info - **2025-10-06** `49b3b1162c55`: 34 info - **2025-10-03** `9d74dd4eed89`: 2 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 optional property `allOf[subschema #2: Virtual Machine Specification]/usbAccessories` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/usbAccessories` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-09** `68275a31b1dd`: 2 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/startup_script/transport` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/startup_script/transport` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-08** `cea110fafcf3`: 4 warning, 4 info - removed the optional property `allOf[subschema #2: Virtual Machine Specification]/noAudio` from the response with the `200` status (media type: application/json) - removed the optional property `allOf[subschema #2: Virtual Machine Specification]/noClipboard` from the response with the `200` status (media type: application/json) - removed the optional property `object/allOf[subschema #2: Virtual Machine Specification]/noAudio` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/allOf[subschema #2: Virtual Machine Specification]/noClipboard` from the response with the `200` status (media type: application/x-ndjson) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/audio` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/clipboard` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/audio` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/clipboard` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-07** `c999f43e927d`: 4 info - added the required property `allOf[subschema #2: Virtual Machine Specification]/endpoints/items/protocol` to the response with the `200` status (media type: application/json) - added the required property `allOf[subschema #3: Virtual Machine State]/observedEndpoints/items/protocol` to the response with the `200` status (media type: application/json) - added the required property `object/allOf[subschema #2: Virtual Machine Specification]/endpoints/items/protocol` to the response with the `200` status (media type: application/x-ndjson) - added the required property `object/allOf[subschema #3: Virtual Machine State]/observedEndpoints/items/protocol` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-02** `8c00d644b0ad`: 2 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/hostProcesses` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/hostProcesses` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-02** `5efcfd8e9f35`: 4 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/endpoints` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #3: Virtual Machine State]/observedEndpoints` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/endpoints` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #3: Virtual Machine State]/observedEndpoints` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-01** `e3d343d89278`: 2 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/noClipboard` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/noClipboard` to the response with the `200` status (media type: application/x-ndjson) - **2026-09-01** `6436dc8cb457`: 2 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/noAudio` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/noAudio` to the response with the `200` status (media type: application/x-ndjson) - **2026-03-16** `22c44b5665e6`: 10 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/arch` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/localName` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/os` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/runtime` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/arch` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/localName` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/os` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/runtime` to the response with the `200` status (media type: application/x-ndjson) - response property `allOf[subschema #2: Virtual Machine Specification]/tartName` deprecated (media type: application/json) - response property `object/allOf[subschema #2: Virtual Machine Specification]/tartName` deprecated (media type: application/x-ndjson) - **2025-12-02** `ddc34c1a7aa4`: 4 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/powerState` to the response with the `200` status (media type: application/json) - added the optional property `allOf[subschema #2: Virtual Machine Specification]/tartName` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/powerState` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/tartName` to the response with the `200` status (media type: application/x-ndjson) - **2025-11-11** `67700035bf96`: 2 info - the response optional property `allOf[subschema #1: Virtual Machine Metadata]/name` became not read-only for the status `200` (media type: application/json) - the response optional property `object/allOf[subschema #1: Virtual Machine Metadata]/name` became not read-only for the status `200` (media type: application/x-ndjson) - **2025-11-11** `266972c74d44`: 2 info - added the optional property `allOf[subschema #2: Virtual Machine Specification]/suspendable` to the response with the `200` status (media type: application/json) - added the optional property `object/allOf[subschema #2: Virtual Machine Specification]/suspendable` to the response with the `200` status (media type: application/x-ndjson) - **2025-11-06** `eb0a5b3ac3ed`: 46 warning, 2 info - removed the optional property `cpu` from the response with the `200` status (media type: application/json) - removed the optional property `diskSize` from the response with the `200` status (media type: application/json) - removed the optional property `headless` from the response with the `200` status (media type: application/json) - removed the optional property `hostDirs` from the response with the `200` status (media type: application/json) - removed the optional property `image` from the response with the `200` status (media type: application/json) - removed the optional property `imagePullPolicy` from the response with the `200` status (media type: application/json) - removed the optional property `labels` from the response with the `200` status (media type: application/json) - removed the optional property `memory` from the response with the `200` status (media type: application/json) - removed the optional property `name` from the response with the `200` status (media type: application/json) - removed the optional property `nested` from the response with the `200` status (media type: application/json) - removed the optional property `net-bridged` from the response with the `200` status (media type: application/json) - removed the optional property `net-softnet` from the response with the `200` status (media type: application/json) - removed the optional property `netSoftnet` from the response with the `200` status (media type: application/json) - removed the optional property `netSoftnetAllow` from the response with the `200` status (media type: application/json) - removed the optional property `netSoftnetBlock` from the response with the `200` status (media type: application/json) - removed the optional property `object/cpu` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/diskSize` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/headless` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/hostDirs` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/image` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/imagePullPolicy` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/labels` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/memory` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/name` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/nested` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/net-bridged` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/net-softnet` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/netSoftnet` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/netSoftnetAllow` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/netSoftnetBlock` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/password` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/resources` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/restart_policy` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/startup_script` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/status` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/status_message` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/username` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `object/worker` from the response with the `200` status (media type: application/x-ndjson) - removed the optional property `password` from the response with the `200` status (media type: application/json) - removed the optional property `resources` from the response with the `200` status (media type: application/json) - …8 more - **2025-10-27** `349c4709fa60`: 8 info - added the optional property `netSoftnet` to the response with the `200` status (media type: application/json) - added the optional property `netSoftnetAllow` to the response with the `200` status (media type: application/json) - added the optional property `netSoftnetBlock` to the response with the `200` status (media type: application/json) - added the optional property `object/netSoftnet` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/netSoftnetAllow` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/netSoftnetBlock` to the response with the `200` status (media type: application/x-ndjson) - response property `net-softnet` deprecated (media type: application/json) - response property `object/net-softnet` deprecated (media type: application/x-ndjson) - **2025-10-07** `fbfcc3358a84`: 2 info - added the optional property `object/startup_script` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `startup_script` to the response with the `200` status (media type: application/json) - **2025-10-06** `49b3b1162c55`: 34 info - added the optional property `cpu` to the response with the `200` status (media type: application/json) - added the optional property `diskSize` to the response with the `200` status (media type: application/json) - added the optional property `headless` to the response with the `200` status (media type: application/json) - added the optional property `image` to the response with the `200` status (media type: application/json) - added the optional property `imagePullPolicy` to the response with the `200` status (media type: application/json) - added the optional property `labels` to the response with the `200` status (media type: application/json) - added the optional property `memory` to the response with the `200` status (media type: application/json) - added the optional property `net-bridged` to the response with the `200` status (media type: application/json) - added the optional property `net-softnet` to the response with the `200` status (media type: application/json) - added the optional property `object/cpu` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/diskSize` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/headless` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/image` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/imagePullPolicy` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/labels` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/memory` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/net-bridged` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/net-softnet` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/password` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/restart_policy` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/status` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/status_message` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/username` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `object/worker` to the response with the `200` status (media type: application/x-ndjson) - added the optional property `password` to the response with the `200` status (media type: application/json) - added the optional property `restart_policy` to the response with the `200` status (media type: application/json) - added the optional property `status` to the response with the `200` status (media type: application/json) - added the optional property `status_message` to the response with the `200` status (media type: application/json) - added the optional property `username` to the response with the `200` status (media type: application/json) - added the optional property `worker` to the response with the `200` status (media type: application/json) - the response optional property `name` became read-only for the status `200` (media type: application/json) - the response optional property `object/name` became read-only for the status `200` (media type: application/x-ndjson) - the `nested` response's property default value `false` was added for the status `200` (media type: application/json) - the `nested` response's property default value `false` was added for the status `200` (media type: application/x-ndjson) - **2025-10-03** `9d74dd4eed89`: 2 info - added the new optional `query` request parameter `watch` to all path's operations - added the media type `application/x-ndjson` for the response with the status `200` - **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 - the response's body type changed from `object` to no type for status `200` - removed the media type `application/x-ndjson` for the response with the 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/get.md) - [API](https://skmtc.dev/openai/apis/orchard.md) - [Page](https://skmtc.dev/openai/apis/orchard/changes/vms/:name/get)