Skip to main content
POST
/
vm
Create a vm
curl --request POST \
  --url https://iaas-api.liara.ir/vm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "OS": "ubuntu-24.04",
  "plan": "standard-base-g2",
  "config": {
    "SSHKeys": [
      "<string>"
    ]
  }
}
'
{
  "taskID": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string

Lowercase vm name

​
OS
enum<string>

The os name

Available options:
ubuntu-24.04,
ubuntu-22.04,
debian-12.9
​
plan
enum<string>

The plan of app that you want to create

Available options:
standard-base-g2,
standard-plus-g2,
pro-g2,
pro-plus-g2,
express-g2,
express-plus-g2
​
config
object

The config of vm that you want to create

Response

Successful operation

​
taskID
string