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

Attach virtual media

Attaches an ISO file as virtual media and boots the server from it. The server must be powered off.

Parameters

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

Request Body

idstringRequired

The filename of the ISO to attach

Response

200

400

403

404

successboolean

Request

curl -X POST "https://api.royalehosting.net/dashboard/service/{id}/dedicated/virtual-media" \
  -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", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "x-organization-id": "YOUR_ORG_ID",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "id": "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",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-organization-id": "YOUR_ORG_ID",
    }
)

print(response.json())

Response

{
  "success": true
}