Add ISO

Create a new ISO file by providing a valid direct download URL. The system will start downloading the file automatically.

⚠ Important:

The URL must be a valid HTTP/HTTPS link that is directly accessible without authentication.

Links from file-sharing services (e.g., Google Drive, Dropbox, OneDrive) will not work because they require login or token-based access.

The URL must end with .iso, ensuring it links to an actual ISO file.

All ISO files are automatically deleted 48 hours after the download is completed.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

string

required

Default:

application/json

Body Params application/json

url

string

required

>= 3 characters<= 100 characters

Example:

https://releases.ubuntu.com/24.04.1/ubuntu-24.04.1-live-server-amd64.iso

Example

Responses

🟢201ISO is being downloaded

application/json

Body

integer

required

status

string

required

Can be: downloading, downloaded, deleted

Example:

downloaded

name

string

required

Example:

AlmaLinux-9.5-x86_64-boot.iso

size

integer

required

The total file size in bytes. Represents the full size of the ISO/image being downloaded.

downloaded

integer

required

The number of bytes successfully downloaded so far. When this equals size, the download is complete.

created_at

string

required

Example:

2025-02-03T10:58:19.000000Z

deletion_at

string

required

All ISO files are automatically deleted after 48 hours of their creation.

Example

{
  "id": 1,
  "status": "downloaded",
  "name": "AlmaLinux-9.5-x86_64-boot.iso",
  "size": 1111998464,
  "downloaded": 1111998464,
  "created_at": "2025-02-03T10:58:19.000000Z",
  "deletion_at": "2025-02-05T10:58:19.000000Z"
}

🔴500Server Error

Request

Request samples

Responses