Remove or detach an ISO file from a VM

Remove an ISO file from a virtual machine (VM) or detach it. This is useful when you want to free up disk space or switch to a different ISO. You need the 'volid' from GET /api/vm/{vmid}/iso to run this.

VPS Services VM

Context

Where to get IDs / values

path.vmid

GET /api/vps-accounts

Workflow links

Requires

volid from GET /api/vm/{vmid}/iso

Produces

volid → data.volid

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 POST /api/vm/{vmid}/iso Mount an ISO file to a VPS for installation or troubleshooting GET /api/vm/{vmid}/disks Get disk information for a VM

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Query Parameters

action string · enum required · Example: unmount

delete

unmount

device string · Example: ide2

volid string · Example: iso:iso/example.com.iso

Headers

Accept Example

Content-Type Example

Responses

200

data object required

data.device string · Example: ide2

data.message string required · Example: ISO unmounted successfully

Human-readable message.

data.volid string · Example: iso:iso/example.com.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).

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

For AI assistants

cURL

curl -X DELETE "https://cloud.hostup.se/api/vm/10000/iso?action=unmount" \
  -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": {
    "message": "ISO unmounted successfully",
    "device": "ide2"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "device": {
          "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)."
    }
  }
}