---
title: "Create a vm"
method: POST
path: "/vm"
tags: ["VMs"]
---

# Create a vm

`POST /vm`

create a vm that user owns

## Request body

- CreateVMRequest
  - `name` string — Lowercase vm name
  - `OS` 'ubuntu-24.04' | 'ubuntu-22.04' | 'debian-12.9' — The os name
  - `plan` 'standard-base-g2' | 'standard-plus-g2' | 'pro-g2' | 'pro-plus-g2' | 'express-g2' | 'express-plus-g2' — The plan of app that you want to create
  - `config` object — The config of vm that you want to create
    - `SSHKeys` string[]

## Response `200`

Successful operation

- object
  - `taskID` string

## Other responses

- `400` — Bad request
- `401` — Missing authentication
- `402` — Payment required
- `409` — Conflict
- `412` — Precondition failed
- `429` — Too many request

---

[API](https://skmtc.net/liara-cloud/apis/liara-iaas-api-documentaion.md) · [All operations](https://skmtc.net/liara-cloud/apis/liara-iaas-api-documentaion/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liara-cloud/liara-iaas-api-documentaion/versions/9cf834141a49/schema)