---
title: "Changes to List VMs"
method: GET
path: "/vms"
---

# Changes to List VMs

`GET /vms`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 42 revisions.

- **2026-09-23** `08cc2c61827f`: 1 info
- **2026-09-09** `68275a31b1dd`: 1 info
- **2026-09-08** `cea110fafcf3`: 2 warning, 2 info
- **2026-09-07** `c999f43e927d`: 2 info
- **2026-09-02** `8c00d644b0ad`: 1 info
- **2026-09-02** `5efcfd8e9f35`: 2 info
- **2026-09-01** `e3d343d89278`: 1 info
- **2026-09-01** `6436dc8cb457`: 1 info
- **2026-03-16** `22c44b5665e6`: 5 info
- **2026-01-29** `df654b7363ed`: 1 info
- **2025-12-02** `ddc34c1a7aa4`: 2 info
- **2025-11-11** `67700035bf96`: 1 info
- **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-09-26** `ece9486be282`: 1 info
- **2023-10-09** `e0632c7e52ea`: 1 breaking, 3 info
- **2023-01-26** `4b9547159dde`: 1 breaking, 1 warning, 1 info

## Changes

- **2026-09-23** `08cc2c61827f`: 1 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/usbAccessories` to the response with the `200` status
- **2026-09-09** `68275a31b1dd`: 1 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/startup_script/transport` to the response with the `200` status
- **2026-09-08** `cea110fafcf3`: 2 warning, 2 info
  - removed the optional property `items/allOf[subschema #2: Virtual Machine Specification]/noAudio` from the response with the `200` status
  - removed the optional property `items/allOf[subschema #2: Virtual Machine Specification]/noClipboard` from the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/audio` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/clipboard` to the response with the `200` status
- **2026-09-07** `c999f43e927d`: 2 info
  - added the required property `items/allOf[subschema #2: Virtual Machine Specification]/endpoints/items/protocol` to the response with the `200` status
  - added the required property `items/allOf[subschema #3: Virtual Machine State]/observedEndpoints/items/protocol` to the response with the `200` status
- **2026-09-02** `8c00d644b0ad`: 1 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/hostProcesses` to the response with the `200` status
- **2026-09-02** `5efcfd8e9f35`: 2 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/endpoints` to the response with the `200` status
  - added the optional property `items/allOf[subschema #3: Virtual Machine State]/observedEndpoints` to the response with the `200` status
- **2026-09-01** `e3d343d89278`: 1 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/noClipboard` to the response with the `200` status
- **2026-09-01** `6436dc8cb457`: 1 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/noAudio` to the response with the `200` status
- **2026-03-16** `22c44b5665e6`: 5 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/arch` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/localName` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/os` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/runtime` to the response with the `200` status
  - response property `items/allOf[subschema #2: Virtual Machine Specification]/tartName` deprecated
- **2026-01-29** `df654b7363ed`: 1 info
  - added the new optional `query` request parameter `filter`
- **2025-12-02** `ddc34c1a7aa4`: 2 info
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/powerState` to the response with the `200` status
  - added the optional property `items/allOf[subschema #2: Virtual Machine Specification]/tartName` to the response with the `200` status
- **2025-11-11** `67700035bf96`: 1 info
  - the response optional property `items/allOf[subschema #1: Virtual Machine Metadata]/name` became not read-only for the status `200`
- **2025-11-11** `266972c74d44`: 1 info
  - added the optional property `items/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 `items/cpu` from the response with the `200` status
  - removed the optional property `items/diskSize` from the response with the `200` status
  - removed the optional property `items/headless` from the response with the `200` status
  - removed the optional property `items/hostDirs` from the response with the `200` status
  - removed the optional property `items/image` from the response with the `200` status
  - removed the optional property `items/imagePullPolicy` from the response with the `200` status
  - removed the optional property `items/labels` from the response with the `200` status
  - removed the optional property `items/memory` from the response with the `200` status
  - removed the optional property `items/name` from the response with the `200` status
  - removed the optional property `items/nested` from the response with the `200` status
  - removed the optional property `items/net-bridged` from the response with the `200` status
  - removed the optional property `items/net-softnet` from the response with the `200` status
  - removed the optional property `items/netSoftnet` from the response with the `200` status
  - removed the optional property `items/netSoftnetAllow` from the response with the `200` status
  - removed the optional property `items/netSoftnetBlock` from the response with the `200` status
  - removed the optional property `items/password` from the response with the `200` status
  - removed the optional property `items/resources` from the response with the `200` status
  - removed the optional property `items/restart_policy` from the response with the `200` status
  - removed the optional property `items/startup_script` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
  - removed the optional property `items/status_message` from the response with the `200` status
  - removed the optional property `items/username` from the response with the `200` status
  - removed the optional property `items/worker` from the response with the `200` status
  - added `#/components/schemas/VMMeta, #/components/schemas/VMSpec, #/components/schemas/VMState` to the `items/` response property `allOf` list for the response status `200`
- **2025-10-27** `349c4709fa60`: 4 info
  - added the optional property `items/netSoftnet` to the response with the `200` status
  - added the optional property `items/netSoftnetAllow` to the response with the `200` status
  - added the optional property `items/netSoftnetBlock` to the response with the `200` status
  - response property `items/net-softnet` deprecated
- **2025-10-07** `fbfcc3358a84`: 1 info
  - added the optional property `items/startup_script` to the response with the `200` status
- **2025-10-06** `49b3b1162c55`: 17 info
  - added the optional property `items/cpu` to the response with the `200` status
  - added the optional property `items/diskSize` to the response with the `200` status
  - added the optional property `items/headless` to the response with the `200` status
  - added the optional property `items/image` to the response with the `200` status
  - added the optional property `items/imagePullPolicy` to the response with the `200` status
  - added the optional property `items/labels` to the response with the `200` status
  - added the optional property `items/memory` to the response with the `200` status
  - added the optional property `items/net-bridged` to the response with the `200` status
  - added the optional property `items/net-softnet` to the response with the `200` status
  - added the optional property `items/password` to the response with the `200` status
  - added the optional property `items/restart_policy` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/status_message` to the response with the `200` status
  - added the optional property `items/username` to the response with the `200` status
  - added the optional property `items/worker` to the response with the `200` status
  - the response optional property `items/name` became read-only for the status `200`
  - the `nested` response's property default value `false` was added for the status `200`
- **2025-09-26** `ece9486be282`: 1 info
  - added the optional property `items/nested` to the response with the `200` status
- **2023-10-09** `e0632c7e52ea`: 1 breaking, 3 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `items/hostDirs` to the response with the `200` status
  - added the optional property `items/name` to the response with the `200` status
  - added the optional property `items/resources` to the response with the `200` status
- **2023-01-26** `4b9547159dde`: 1 breaking, 1 warning, 1 info
  - the `items/` response's property type changed from `object` to no type for status `200`
  - deleted the `query` request parameter `filter`
  - removed `#/components/schemas/VMMeta, #/components/schemas/VMSpec, #/components/schemas/VMState` from the `items/` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/openai/apis/orchard/docs/vms/get.md) - [API](https://skmtc.dev/openai/apis/orchard.md) - [Page](https://skmtc.dev/openai/apis/orchard/changes/vms/get)
