Skip to main content
POST
/
projects
/
{id}
/
vms
Create VM
curl --request POST \
  --url https://api.mkinf.io/v0.1/projects/{id}/vms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "mkinf-node-01",
  "type": "l40s-48gb.1x",
  "location": "us-east1-a",
  "image": "ubuntu22.04-nvidia-pcie-docker",
  "ssh_public_key": "ssh-rsa AAAAB..."
}'
{
  "operation": {
    "completed_at": "2021-12-03T19:59:34Z",
    "metadata": {},
    "operation_id": "F6EF489C-086E-458D-B812-7962964A28C9",
    "result": {},
    "started_at": "2021-12-03T19:58:34Z",
    "state": "IN_PROGRESS"
  }
}
Create a new VM instance in a project.

​
Required Parameters

  • name: VM name
  • type: VM type/size
  • location: Deployment location
  • ssh_public_key: SSH public key for access

​
Optional Parameters

  • image: OS image name
  • disks: Additional disk configurations
  • startup_script: Script to run on startup
  • shutdown_script: Script to run on shutdown

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string<uuid>
required

Project id

Body

application/json
​
name
string
required

Name

​
type
string
required

VM Type

​
location
string
required

Location

​
ssh_public_key
string
required

SSH public key

​
image
string

Image name

​
disks
object[]

Disks

​
startup_script
string

Startup script

​
shutdown_script
string

Shutdown script

Response

200 - application/json
​
operation
object
required