Skip to main content
POST
/
kvm
/
v2
/
set
/
download_iso
Download custom ISO
curl --request POST \
  --url https://{api_host}/kvm/v2/set/download_iso \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data signature=session_signature_12345 \
  --data kvm_id=kvm_xxxxx_yyyyy \
  --data valid_until=1737476000 \
  --data url=http://example.com/my-custom.iso
{
  "status": "success"
}

Body

application/x-www-form-urlencoded

Required parameters to download a custom ISO and add it to the VPS.
All parameters must be passed in the request body as application/x-www-form-urlencoded.

​
signature
string

The session signature obtained from the "Create AUTH-session" call.

Example:

"session_signature_12345"

​
kvm_id
string

The unique identifier of the KVM VPS to which the ISO will be added.
This value is specific to your VPS.

Example:

"kvm_xxxxx_yyyyy"

​
valid_until
string

The expiration timestamp for the session, as obtained from the "Create AUTH-session" call.
Ensure that the session is valid and has not expired.

Example:

"1737476000"

​
url
string

The URL of the ISO file to download.
The provided URL must point to a valid ISO file accessible via HTTP or HTTPS.

Example:

"http://example.com/my-custom.iso"

Response

The custom ISO was successfully downloaded and added to the VPS.

​
status
string

The status of the operation.

Example:

"success"