Skip to main content
POST
/
api
/
v1
/
vms
/
{id}
/
reinstall
Reinstall VM
curl --request POST \
  --url https://api.raffcomputing.com/api/v1/vms/{id}/reinstall \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "password": "<string>",
  "ssh_keys": [
    "<string>"
  ],
  "auto_generate_password": true
}
'
{
  "success": true,
  "message": "Operation completed successfully"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

​
X-Project-ID
string<uuid>
required

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

Path Parameters

​
id
string<uuid>
required

VM ID (UUID)

Body

application/json
​
template_id
string<uuid>
required

ID of the OS template to reinstall with

​
password
string

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

​
ssh_keys
string[]

SSH public keys for authentication

​
auto_generate_password
boolean

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

Response

VM reinstall initiated

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully"