POST /dashboard/service/{id}/dedicated/virtual-media/upload-url

Upload ISO from URL

Downloads an ISO file from a URL (max 10GB) and stores it for virtual media mounting.

Parameters

Name	Type	In	Description
`id`*	`integer`	path	The service ID of the dedicated server

Request Body

urlstringRequired

The URL to download the ISO from

filenamestringRequired

The filename to save the ISO as

Response

200

400

403

404

successboolean

dataobject

filenamestring

sizeGBnumber

messagestring

Request

curl -X POST "https://api.royalehosting.net/dashboard/service/{id}/dedicated/virtual-media/upload-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-organization-id: YOUR_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

Request

const response = await fetch("https://api.royalehosting.net/dashboard/service/{id}/dedicated/virtual-media/upload-url", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "x-organization-id": "YOUR_ORG_ID",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "url": "https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso",
      "filename": "ubuntu-24.04-live-server-amd64.iso"
  }),
});

const data = await response.json();

Request

import requests

response = requests.post(
    "https://api.royalehosting.net/dashboard/service/{id}/dedicated/virtual-media/upload-url",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-organization-id": "YOUR_ORG_ID",
    }
)

print(response.json())

Response

{
  "success": true,
  "data": {
    "filename": "ubuntu-24.04-live-server-amd64.iso",
    "sizeGB": 2.5,
    "message": "Virtual media downloaded successfully"
  }
}