RArafftechnologies
Virtual Machines

Reinstall VM

Changed on

Reinstall a virtual machine with a new OS template. This will destroy all data on the VM.

post/api/v1/vms/{id}/reinstall

Request

  • Base URL
    https://api.rafftechnologies.com
  • URL
    https://api.rafftechnologies.com/api/v1/vms/{id}/reinstall
  • Auth
    API key in header X-API-Key

Path parameters

idstring uuid required

VM ID (UUID)

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Request body

template_idstring uuid required

ID of the OS template to reinstall with

passwordstring

New root/admin password. Either password or auto_generate_password should be provided.

ssh_keysstring[]

SSH keys for authentication, each the id of a saved SSH key or a public key itself. Every key is checked and an invalid entry refuses the request.

auto_generate_passwordboolean

Auto-generate a password and email it to the account owner

Response

VM reinstall initiated

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Operation completed successfully"
}

Changes