Mount an ISO file to a VPS for installation or troubleshooting

Mount an ISO file to your virtual server (VPS). This is useful for installing operating systems, tools, or for troubleshooting your server. The API returns a jobId to track the mounting process via GET /api/jobs/{jobId}.

VPS Services VM

Context

Where to get IDs / values

path.vmid

GET /api/vps-accounts

Workflow links

Produces

jobId → data.jobId

GET /api/jobs/{jobId}
volid → data.volid

DELETE /api/vm/{vmid}/iso
DELETE /api/vm/{vmid}/backups/{volid}
PUT /api/vm/{vmid}/backups

Related endpoints

GET /api/vm/{vmid}/iso Get available ISO images for a VM DELETE /api/vm/{vmid}/iso Remove or detach an ISO file from a VM GET /api/vm/{vmid}/disks Get disk information for a VM

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string · enum required · Example: mount

create_device

download

mount

set_boot_order

bootOrder array · Example: ["scsi0","ide2"]

decompress string · Example: bzip2

device string · enum · Example: ide2

ide1

ide2

ide3

filename string · Example: virtio-win.iso

isoPath string · Example: iso:iso/13493-win-server-2022.iso

url string · Example: https://example.com/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win.iso

Responses

200

data object required

data.bootOrder array<string> · Example: ["scsi0","ide2"]

data.device string · enum · Example: ide2

ide1

ide2

ide3

data.displayName string · Example: virtio-win.iso

data.filename string · Example: 13493-virtio-win.iso

data.iso string · Example: iso:iso/13493-win-server-2022.iso

data.jobId string · Example: downloadISO-18047-1767773197593

data.message string required · Example: ISO mounted successfully

Human-readable message.

data.volid string · Example: iso:iso/13493-virtio-win.iso

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).

500

code string required · Example: INTERNAL_ERROR

Machine-readable error code.

error string required · Example: Internal Server Error

HTTP status title (e.g. 'Bad Request').

message string required · Example: Failed to set boot order

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

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

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/vm/{vmid}/iso

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/10000/iso" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "mount",
    "isoPath": "iso:iso/13493-win-server-2022.iso",
    "device": "ide2"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "message": "ISO mounted successfully",
    "device": "ide2",
    "iso": "iso:iso/13493-win-server-2022.iso"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "bootOrder": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "device": {
          "type": "string",
          "enum": [
            "ide1",
            "ide2",
            "ide3"
          ]
        },
        "displayName": {
          "type": "string"
        },
        "filename": {
          "type": "string"
        },
        "iso": {
          "type": "string"
        },
        "jobId": {
          "type": "string"
        },
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "volid": {
          "type": "string"
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body mount

{
  "action": "mount",
  "isoPath": "iso:iso/13493-win-server-2022.iso",
  "device": "ide2"
}