Skip to main content
POST
/
kvm
/
v2
/
set
/
config
Set Configuration
curl --request POST \
  --url https://{api_host}/kvm/v2/set/config \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data signature=session_signature_12345 \
  --data kvm_id=kvm_xxxxx_yyyyy \
  --data valid_until=1737476000 \
  --data 'config={"boot_timeout":"5000","vnc_keymap":"en-us","cpu_model":"passthrough","disk_driver":"virtio","nw_driver":"virtio","video_driver":"cirrus","description":"fortest","assigned_vlan":"","cpu_set_cores":"core","auto_hydration":"off","tpm":"disabled","uefi":"disabled"}'
{
  "status": "success"
}

Body

application/x-www-form-urlencoded

Parameters required to configure a KVM VPS.

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

Example:

"kvm_xxxxx_yyyyy"

​
valid_until
string

The expiration timestamp for the session, obtained from the 'Create AUTH-session' call.

Example:

"1737476000"

​
config
string
default:{"boot_timeout":"5000","vnc_keymap":"en-us","cpu_model":"passthrough","disk_driver":"virtio","nw_driver":"virtio","video_driver":"cirrus","description":"fortest","assigned_vlan":"","cpu_set_cores":"core","auto_hydration":"off","tpm":"disabled","uefi":"disabled"}

JSON object containing configuration settings.

Supported values:

  • boot_timeout: Boot menu timeout in milliseconds (example: 5000, 10000)
  • uefi: enabled or disabled
  • tpm: enabled or disabled
  • vnc_keymap: Keyboard layout such as en-us, en-gb, de, de-ch, fr, fr-be, fr-ch, es, it, nl, pt, sv, ru, tr, and other layouts available in the control panel
  • cpu_set_cores: core or socket
  • cpu_model: default or passthrough
  • disk_driver: virtio, ide, or scsi
  • nw_driver: virtio, e1000, or rtl8139
  • video_driver: cirrus or qxl
  • description: Custom VPS description
  • assigned_vlan: VLAN ID if VLAN service is enabled
  • auto_hydration: off, 100, 500, or 1000 depending on available hydration packages

Example Configuration:

{"boot_timeout":"10000","vnc_keymap":"en-us","cpu_model":"passthrough","disk_driver":"virtio","nw_driver":"virtio","video_driver":"cirrus","assigned_vlan":"","cpu_set_cores":"core","auto_hydration":"off","tpm":"disabled","uefi":"disabled","description":"fortest"}

⚠️ Compatibility Notice

  • UEFI is disabled by default. A value of uefi=disabled means the VPS will boot using legacy BIOS mode. Setting uefi=enabled switches the VPS to UEFI boot mode.
  • TPM is disabled by default. Setting tpm to enabled enables a Software TPM (vTPM) device for the VPS.

Response

Configuration updated successfully.

​
status
string
Example:

"success"

Last modified on December 17, 2025