Skip to main content

Reinstall OS

POST 

/vms/:vm_id/reinstall

Recreates the system disk and destroys its data. Extra disks are kept unless wipe_extra_disks=true. Supply either a password or SSH public key; omit both to reuse the installation access settings. Both together are invalid. VPS identity, network and paid term are preserved.

Send a unique Idempotency-Key for each intended action. If the response is lost, retry with the same key and unchanged parameters; do not create a new key for the same purchase.

HTTP 202 accepts the request; it does not confirm completion. Save the order_id or operation id and check its status.

Request rules and errors · Lifecycle · Webhooks

Optional cloud-config JSON object, not a YAML string. Maximum 65536 bytes after server JSON serialization (non-ASCII characters are escaped). users, packages, runcmd and write_files must be arrays when present. Networking, hostname and primary access are managed by the platform. Retain the same object when retrying. Its result is reported separately in guest_initialization; cloud_init contents are not returned in orders or webhooks.

Latest installation result: succeeded means cloud-init finished; failed / cloud_init_failed means custom configuration failed; unknown / guest_initialization_timeout means the result was not confirmed within 15 minutes. failed and unknown do not mean a running VPS was not created: its order may be completed and reinstallation succeeded. null means no result is available. Does not confirm application health.

Without an explicit cloud_init, reinstallation retains the saved application and exact installer snapshot. The server service checks that the new OS is compatible. Explicit cloud_init, including {}, replaces the application; application becomes null after successful reinstallation. Selecting a different application_id on reinstall is not supported.

Windows reinstallation uses this same endpoint. The installation login is retained; read it from GET /vms/{vm_id}. Omitted credentials reuse the saved installation access. Windows requires a valid password and does not support SSH keys, Linux applications or custom cloud_init. The existing VPS must have a compatible boot configuration and sufficient disk space; changing an arbitrary Linux VPS to Windows is not guaranteed. Compatibility is checked by the server service. The operation can fail with template_incompatible; check its final status.

Request​

Responses​

Accepted for processing

© 2026 AdaptGroup LLC. All rights reserved.
30 N Gould St Ste R, Sheridan, WY 82801, USA
Back to top