Skip to main content
POST
/
api
/
v1
/
vm
/
branch
/
by_vm
/
{vm_id}
cURL
curl --request POST \
  --url https://api.example.com/api/v1/vm/branch/by_vm/{vm_id} \
  --header 'Authorization: Bearer <token>'
{
  "vms": [
    {
      "vm_id": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
vm_id
string
required

VM to commit and then branch off of

Query Parameters

​
keep_paused
boolean

If true, keep VM paused after commit

​
skip_wait_boot
boolean

If true, immediately return an error if VM is booting instead of waiting

​
count
integer<int32>

Number of VMs to branch (optional; default 1)

Required range: x >= 0

Response

Branch VM(s) created successfully

​
vms
object[]
required