Skip to main content
POST
/
kvm
/
v2
/
set
/
reinstall
Reinstall
curl --request POST \
  --url https://{api_host}/kvm/v2/set/reinstall \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data signature=session_signature_12345 \
  --data kvm_id=kvm_xxxxx_yyyyy \
  --data valid_until=1737476000 \
  --data image=debian-bullseye \
  --data password=your-password \
  --data 'cloudinit_user_data=<string>'
{
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://docs.edisglobal.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/x-www-form-urlencoded

Required parameters to reinstall the operating system.
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 reinstall.
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"

​
image
string

The name of the operating system image to install.
Use the get autoinstall images endpoint to retrieve available images.

Example:

"debian-bullseye"

​
password
string

The root password for the new installation.

⚠️ If "cloudinit_user_data" is provided, this parameter may be ignored depending on the cloud-init configuration.

Example:

"your-password"

​
cloudinit_user_data
string

Optional cloud-init configuration for supported images.

Example:

#cloud-config
write_files:
  - path: /etc/apt/apt.conf.d/99force-ipv4
    content: |
      Acquire::ForceIPv4 'true';
    owner: 'root:root'
    permissions: '0644'
set_hostname: kvmtest
user: root
password: YOUR_ROOT_PASSWORD
disable_root: false
disable_root_opts: ''
ssh_pwauth: False
ssh_authorized_keys:
  - ssh-rsa YOUR_SSH_KEY
manage_etc_hosts: true
expire: False
runcmd:
  - chage -d 19000 root
  - [ /usr/bin/sed, -i, -E, 's/disable_root:.*true/disable_root: false/i', /etc/cloud/cloud.cfg ]
  - [ /usr/bin/sed, -i, -E, 's/PermitRootLogin.*/PermitRootLogin without-password/i', /etc/ssh/sshd_config ]
  - [ /usr/bin/sed, -i, -E, 's/#PermitRootLogin.*/PermitRootLogin yes/i', /etc/ssh/sshd_config ]
users:
  - default
power_state:
  delay: now
  mode: reboot
  message: Bye Bye
  timeout: 30
  condition: True
package_update: false
package_upgrade: false

Refer to the Cloud-init documentation for details.

Response

The operating system was successfully reinstalled on the VPS.

​
status
string

The status of the operation.

Example:

"success"

Last modified on January 28, 2026