POST
/
projects
/
{id}
/
vms
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
required

Project id

Body

application/json

Response

200 - application/json

The response is of type object.