---
title: "Create a VM"
method: POST
path: "/vms"
tags: ["vms"]
---

# Create a VM

`POST /vms`

## Response `200`

VM resource was successfully created

- VM — unresolved $ref

## Other responses

- `409` — VM resource with with the same name already exists

## Changes

- **2023-01-26** `4b9547159dde` — 2 breaking, 1 info
  - removed the request body
  - the response's body type/format changed from `object`/`` to ``/`` 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/post.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/df290e3bee7e/schema)