VPSBG's dev hub
HomePricingKnowledge BaseContact us
HomePricingKnowledge BaseContact us
  1. ISOs
  • šŸ‘‹ Hello
  • API Introduction
    • API Introduction
    • How to generate API key?
  • API Reference
    • User
      • 2FA
        • Get 2FA secret key
        • Enable 2FA
        • Disable 2FA
      • Update user
      • Get account information
    • Balance
      • Balance
      • Deposit funds
      • List balance transactions
    • Affiliate
      • Get affiliate information
      • List conversions
      • List payouts
      • Activate affiliate program
      • Update referral code
    • Invoices
      • List invoices
      • Download an invoice
      • Download invoices
    • Support
      • Tickets
        • List tickets
        • List departments
        • List related services
        • Get a ticket
        • Create new ticket
        • Reply to ticket
        • Mark ticket as resolved
        • Download attachment
      • List plans
      • Purchase support plan
      • Renew support plan
      • Cancel support plan
      • Undo cancel request
    • SSH Keys
      • Get an SSH Key
      • Update SSH Key
      • Delete SSH Key
      • List SSH keys
      • Add SSH Key
    • Servers
      • Scale
        • List plans
        • Calculate scale cost
        • Scale a server
      • Addons
        • List available addons
        • Scale addons
        • Calculate scale cost
        • Purchase new addons
        • Cancel addon
        • Undo cancel request
      • Rescue
        • Enable rescue mode
        • Disable rescue mode
      • List plans
      • List servers
      • Server status
      • Get a server
      • Server metrics
      • Bandwidth
      • Deploy new server
      • Start a server
      • Restart a server
      • Stop a server
      • Power off
      • Cancel server
      • Undo cancel request
      • Change password
      • Update hostname
      • Update SSH Keys
      • Modify ISOs
      • Restore
      • Renew server
      • Reinstall Server
      • Change Primary IP
      • Calculate renew amount
    • Plans
      • Plan addon
      • Plan promo-codes
    • Snapshots
      • List snapshots
      • Delete snapshot
    • Backups
      • List backups
      • Delete backup
    • Server Images
      • List server images
    • Floating IPs
      • List Floating IPs
      • Plans
      • Purchase Floating IPs
      • Attach Floating IP
      • Detach Floating IP
      • Cancel Floating IP
      • Delete Floating IP Cancellation
    • IP Addresses
      • Update IP address
    • Network Protection
      • Geo filter
        • Get current geo filter
        • Set geo filter
        • Update geo filter
        • Delete geo filter
      • Whitelist
        • Get status and list of IPs
        • Whitelist IP addresses
        • Update IP addresses list
        • Delete all rules
      • Blacklist
        • Get status and list of IPs
        • Blacklist IP addresses
        • Update IP addresses list
        • Delete all rules
      • General information
      • Bandwidth
      • List blocked IPs
      • List attacks
      • Get an attack
      • Attack bandwidth
    • Orders
      • List orders
      • Get an order
      • Delete order
      • Pay orders
      • Update order
      • Change renewal period
    • ISOs
      • Get an ISO
        GET
      • Delete an ISO
        DELETE
      • List ISOs
        GET
      • Add ISO
        POST
  1. ISOs

Add ISO

POST
https://api.vpsbg.eu/v1/isos
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
Accept
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
{
  "url": "https://releases.ubuntu.com/24.04.1/ubuntu-24.04.1-live-server-amd64.iso"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.vpsbg.eu/v1/isos' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://releases.ubuntu.com/24.04.1/ubuntu-24.04.1-live-server-amd64.iso"
}'

Responses

🟢201ISO is being downloaded
application/json
Body
id
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
Previous
List ISOs
Built with