1. Virtual Private Servers
my.host API
  • Getting started
    • Introduction
    • Base url
    • Authentication
    • Response codes
    • Changelog
  • Domains
    • Domains
      • DNS
        • Zone
          • Get DNS zonefile
          • Import DNS zonefile
        • Dynamic DNS
          • List Dynamic DNS credentials
          • Create Dynamic DNS credential
          • Delete Dynamic DNS credential
          • Reset Dynamic DNS password
        • Get DNS records
        • Update DNS records
        • Update single DNS record
        • Delete single DNS record
        • Add single DNS record
        • Get DNS history
      • List domains
      • Get domain
      • Update domain
      • Cancel domain
      • Cancel domain deletion
      • Get auth code
      • Retry registration or transfer
      • Resend owner verification
    • Contacts
      • List profiles
      • Get profile
      • Create profile
      • Update profile
      • Delete profile
      • Get profile
      • Update profile
    • Nameservers
      • List profiles
      • Get profile
      • Create profile
      • Update profile
      • Delete profile
    • DNS templates
      • List templates
      • Get template
      • Create template
      • Update template
      • Delete template
    • Availability
      • Check domain availability
      • Check availability of several domains
    • Order
      • Order domain
    • Extensions
      • List domain extensions
      • Get domain extension
  • Virtual Private Servers
    • Backups
      • List backups
      • Create backup
      • Restore backup
      • Delete backup
    • SSH keys
      • List SSH keys
      • Delete SSH key
      • Add SSH key
    • Firewall
      • Get VPS firewall
      • Update VPS firewall
    • VPC
      • Get VPS VPC
      • Create VPS VPC
      • Add VPC subnet
      • Attach VPC subnet
    • Order
      • List VPS products
      • Order VPS
    • Floating IPs
      • List floating IPs
      • Reserve floating IP
      • Attach floating IP
      • Detach floating IP
      • Delete floating IP
    • List VPS instances
      GET
    • VPS details
      GET
    • Update VPS
      PUT
    • Restart VPS
      POST
    • Enable or disable rescue mode
      PUT
    • Cancel VPS
      DELETE
    • Cancel VPS deletion
      PUT
    • List available OS images
      GET
    • Reinstall VPS
      POST
    • Start VPS
      POST
    • Stop VPS
      POST
    • Power off VPS
      POST
    • Reset VPS root password
      POST
    • Change VPS hostname
      PUT
    • Get VPS statistics
      GET
    • List VPS licenses
      GET
  • Certificates
    • List certificates
    • Get certificate
    • List certificate products
    • Order certificate
    • Generate CSR
    • Request certificate
  • Orders
    • List orders
    • Get order
    • Update order
  • Affiliate
    • Commissions
      • List affiliate commissions
      • Get affiliate commission
    • Payments
      • List affiliate payments
      • Get affiliate payment
  • Account
    • Profile
      • Get account profile
      • Update account profile
    • Payment methods
      • List payment methods
      • Update default payment method
    • Invoices
      • List invoices
      • Get invoice
      • Download invoice PDF
    • Users
      • List account users
      • Get account user
      • Create account user
      • Update account user
    • Tickets
      • List support tickets
      • Get support ticket
      • Create support ticket
      • Reply to support ticket
  • Tools
    • Get your IP and customer number
  1. Virtual Private Servers

Reinstall VPS

POST
/vps/{id}/reinstall
Reinstall the VPS with the given OS image. A new root password is generated and returned. To restore from a backup instead, use PATCH /vps/{id}/backups.
Not available for a managed VPS: my.host manages its root account, so the request gets 403. Restoring a backup still works.

Request

Authorization
API Key
Add parameter in header
API-key
Example:
API-key: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Body Params application/jsonRequired

Example
{
    "image_id": 50
}

Request Code 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 'https://mijn.host/api/v2/vps/12345/reinstall' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "image_id": 50
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "status": "string",
    "status_description": "string",
    "details": {
        "root_password": "string"
    }
}
🟠400Wrong request method
🟠400SSL connection is required
🟠400Image errors
🟠400Could not determine VPS server
🟠400No access to this VPS
🟠403A managed VPS cannot be reinstalled
🟠400No valid VPS ID provided
🟠401No valid API key set
🟠401API key has expired
🟠401Remote IP address is not found in the API key whitelist
🔴500Error
Modified at 2026-11-13 09:40:27
Previous
List available OS images
Next
Start VPS
Built with