API Documentation

Mount ISO

Mount or unmount an ISO image on a VPS. Mounting an ISO allows booting from a custom installation image.

Request

POST /api/v1/vps/{id}/iso

Required scope: vps:write

Path Parameters

Parameter Type Description
id string The VPS ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY
Content-Type Yes application/json

Request Body

Field Type Required Description
os string | null Yes ISO identifier to mount, or null to unmount

Mount an ISO:

{
  "os": "ubuntu-24.04-live"
}

Unmount the current ISO:

{
  "os": null
}

Response

Mount response:

{
  "data": {
    "mounted": true,
    "os": "ubuntu-24.04-live",
    "success": true
  }
}

Unmount response:

{
  "data": {
    "mounted": false,
    "success": true
  }
}

Response Fields

Field Type Description
mounted boolean Whether an ISO is now mounted
os string The mounted ISO identifier (only present when mounting)
success boolean Whether the action was accepted

Errors

Status Code Description
400 MISSING_FIELD The os field is not present in the request body
400 INVALID_OS The os value is not a string or null
404 NOT_FOUND VPS not found or not accessible
502 PROVIDER_ERROR Upstream provider error

Example

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/iso" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"os": "ubuntu-24.04-live"}'

MCP

This action is also available via the vm_mount_iso MCP tool.