---
title: "Update a VM"
method: PUT
path: "/vms/{name}"
tags: ["vms"]
---

# Update a VM

`PUT /vms/{name}`

## Response `200`

VM object was successfully updated

- VM
  - `name` string — VM name
  - `resources` object — Dictionary that maps the resource name to the amount of this resource required on the worker for this VM to be scheduled
  - `hostDirs` object[]
    - `name` string
    - `path` string
    - `ro` boolean

## Other responses

- `404` — VM resource with the given name doesn't exist

## Changes

- **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`

[Change history](https://skmtc.dev/openai/apis/orchard/changes/vms/:name/put.md)

---

[API](https://skmtc.dev/openai/apis/orchard.md) · [All operations](https://skmtc.dev/openai/apis/orchard/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/orchard/revisions/9d2bc7a08ffc/schema)