POST
/
kvm
/
v2
/
set
/
reinstall
curl --request POST \
  --url https://{api_host}.edisglobal.com/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=2025-01-12T15:30:00Z \
  --data image=debian-bullseye \
  --data password=your-password \
  --data 'pubkey=ssh-rsa AAAAB3Nza...' \
  --data 'postscript=#!/bin/sh
echo Hello World' \
  --data 'cloudinit_user_data=#cloud-config
set_hostname: YOUR_HOSTNAME
user: root
password: YOUR_ROOT_PASSWORD
ssh_pwauth: True
manage_etc_hosts: true
'
{
  "status": "success"
}

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:

"2025-01-12T15:30:00Z"

​
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.

Example:

"your-password"

​
pubkey
string

(Deprecated) An optional SSH public key to configure for root access.
Use cloud-init user data for advanced configurations.

Example:

"ssh-rsa AAAAB3Nza..."

​
postscript
string

(Deprecated) An Optional script to execute after the installation completes.
Use this for post-installation tasks.

Example:

"#!/bin/sh\necho Hello World"

​
cloudinit_user_data
string

Optional configuration for images supporting cloud-init.
Refer to the Cloud-init documentation for details.

Example:

"#cloud-config\nset_hostname: YOUR_HOSTNAME\nuser: root\npassword: YOUR_ROOT_PASSWORD\nssh_pwauth: True\nmanage_etc_hosts: true\n"

Response

200
application/json
The operating system was successfully reinstalled on the VPS.
​
status
string

The status of the operation.

Example:

"success"

Was this page helpful?