---
title: "Download custom ISO"
method: POST
path: "/kvm/v2/set/download_iso"
tags: ["Installation"]
---

# Download custom ISO

`POST /kvm/v2/set/download_iso`

## Request

- Base URL: `https://api_host.edisglobal.com`
- URL: `https://api_host.edisglobal.com/kvm/v2/set/download_iso`
- Auth: none required
- TypeScript: <https://skmtc.dev/edisglobal/apis/edis-global-management-api/docs/kvm/v2/set/download_iso/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint downloads a custom ISO from a provided URL and adds it to the specified KVM VPS.  
The `api_host` parameter, obtained from the "Create AUTH-session" response,  
is dynamically set in the URL.  
Provide the `signature`, `kvm_id`, `valid_until`, and the `url` of the ISO to be downloaded.

## Request body `application/x-www-form-urlencoded`

- SetDownloadIsoBody
  - `signature` string: The session signature obtained from the "Create AUTH-session" call.
  - `kvm_id` string: The unique identifier of the KVM VPS to which the ISO will be added. This value is specific to your VPS.
  - `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.
  - `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.

## Response `200`

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

- InlineResponse2003
  - `status` string
  - `kvmid` string
  - `serviceid` string

## Other responses

- `400`: Bad Request - Invalid parameters or missing fields.
- `401`: Unauthorized - The session signature is invalid or expired.
- `403`: Forbidden - The client does not have permission to access this resource.
- `500`: Internal Server Error - An unexpected error occurred.

---

[API](https://skmtc.dev/edisglobal/apis/edis-global-management-api.md) - [All operations](https://skmtc.dev/edisglobal/apis/edis-global-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/edisglobal/apis/edis-global-management-api/revisions/223263c91ac0?raw)