Get available ISO images for a VM

List all available ISO images that can be mounted on a specific virtual machine (VM). The information returns a 'volid' that you can then use to call DELETE /api/vm/{vmid}/iso to unmount the image.

VPS Services VM

Context

Where to get IDs / values

Workflow links

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.available array<object> required · Example: [{"volid":"iso:iso/12295-Win10_22H2_EnglishInternational_x64v1.iso","name":"12295-Win10...
data.available[].ctime integer required · Example: 1768230975
data.available[].displayName string required · Example: Win10_22H2_EnglishInternational_x64v1.iso
data.available[].format string required · Example: iso
data.available[].name string required · Example: 12295-Win10_22H2_EnglishInternational_x64v1.iso
data.available[].size integer required · Example: 6135633920
data.available[].storage string required · Example: iso
data.available[].volid string required · Example: iso:iso/12295-Win10_22H2_EnglishInternational_x64v1.iso
data.availableDevices array<object> required · Example: [{"device":"ide1","type":"existing_cdrom","description":"IDE1 (Existing CD/DVD)","inUse...
data.availableDevices[].description string required · Example: IDE1 (Existing CD/DVD)
data.availableDevices[].device string · enum required · Example: ide1
ide1
ide2
ide3
sata0
sata1
sata2
data.availableDevices[].inUse boolean required · Example: false
data.availableDevices[].type string · enum required · Example: existing_cdrom
available
existing_cdrom
data.bootOrder object required
data.bootOrder.availableDevices array<object> required · Example: [{"id":"scsi0","name":"SCSI0 (Disk)","type":"disk"},{"id":"ide3","name":"IDE3 (Disk)","...
data.bootOrder.availableDevices[].id string required · Example: scsi0
data.bootOrder.availableDevices[].name string required · Example: SCSI0 (Disk)
data.bootOrder.availableDevices[].type string · enum required · Example: disk
cdrom
disk
network
data.bootOrder.devices object required
data.bootOrder.devices.ide1 string · Example: IDE1 (CD/DVD)
data.bootOrder.devices.ide2 string required · Example: IDE2 (CD/DVD)
data.bootOrder.devices.ide3 string · Example: IDE3 (Disk)
data.bootOrder.devices.net0 string required · Example: Network (PXE)
data.bootOrder.devices.scsi0 string required · Example: SCSI0 (Disk)
data.bootOrder.order array<string> required · Example: ["scsi0"]
data.bootOrder.rawConfig string · enum required · Example: order=scsi0
order=ide2;scsi0
order=ide2;scsi0;ide3;ide1
order=scsi0
order=scsi0;ide3;ide1
data.mounted array<object> required · Example: [{"device":"ide1","iso":null,"mounted":false,"config":"none,media=cdrom","isCloudInit":...
data.mounted[].config string required · Example: none,media=cdrom
data.mounted[].device string · enum required · Example: ide1
ide1
ide2
ide3
data.mounted[].isCloudInit boolean required · Example: false
data.mounted[].iso string · nullable required · Example: iso:iso/12295-Win10_22H2_EnglishInternational_x64v1.iso

Nullable: may be null when not applicable.

data.mounted[].mounted boolean required · Example: false
data.proxmoxVmId string required · Example: 10040
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/vm/{vmid}/iso
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/iso" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "available": [],
    "mounted": [
      {
        "device": "ide1",
        "iso": null,
        "mounted": false,
        "config": "none,media=cdrom",
        "isCloudInit": false
      },
      {
        "device": "ide2",
        "iso": null,
        "mounted": false,
        "config": "none,media=cdrom",
        "isCloudInit": false
      },
      {
        "_truncated": "... and 1 more items"
      }
    ],
    "bootOrder": {
      "order": [
        "scsi0"
      ],
      "devices": {
        "scsi0": "SCSI0 (Disk)",
        "ide3": "IDE3 (Disk)",
        "ide2": "IDE2 (CD/DVD)",
        "ide1": "IDE1 (CD/DVD)",
        "net0": "Network (PXE)"
      },
      "availableDevices": [
        {
          "id": "scsi0",
          "name": "SCSI0 (Disk)",
          "type": "disk"
        },
        {
          "id": "ide3",
          "name": "IDE3 (Disk)",
          "type": "disk"
        },
        {
          "_truncated": "... and 3 more items"
        }
      ],
      "rawConfig": "order=scsi0"
    },
    "availableDevices": [
      {
        "device": "ide1",
        "type": "existing_cdrom",
        "description": "IDE1 (Existing CD/DVD)",
        "inUse": false
      },
      {
        "device": "ide2",
        "type": "existing_cdrom",
        "description": "IDE2 (Existing CD/DVD)",
        "inUse": false
      },
      {
        "_truncated": "... and 8 more items"
      }
    ],
    "proxmoxVmId": "10040"
  }
}