Reinstall status
GET/api/v1/vms/{vm_uuid}/reinstall/status
How the last reinstall went. Kept for 30 minutes after it ends.
Parameters
| Name | In | Description |
|---|---|---|
| vm_uuid | path, stringrequired | Server id, from Create a VM or List VMs |
Example request
curl -X GET "https://platform.serverscamp.com/api/v1/vms/$VM_UUID/reinstall/status" \
-H "Authorization: Bearer $API_TOKEN"import os, requests
token = os.environ["API_TOKEN"]
vm_uuid = "6f1c2a9e-4b3d-4e8a-9c71-2d5e8f0a1b34"
r = requests.get(
f"https://platform.serverscamp.com/api/v1/vms/{vm_uuid}/reinstall/status",
headers={"Authorization": f"Bearer {token}"},
)
r.raise_for_status()
print(r.json())const vmUuid = '6f1c2a9e-4b3d-4e8a-9c71-2d5e8f0a1b34';
const r = await fetch(`https://platform.serverscamp.com/api/v1/vms/${vmUuid}/reinstall/status`, {
method: 'GET',
headers: { Authorization: `Bearer ${process.env.API_TOKEN}` },
});
console.log(r.status, await r.json());Answer
Status 200 with this body.
| Field | Type | Description |
|---|---|---|
| vm_uuid | stringrequired | |
| from_template_name | string, optional | System before |
| to_template_name | string, optional | System after |
| step | stringrequired | queued, applying, done or failed |
| started_at | stringrequired | |
| completed_at | string, optional | |
| error | string, optional | What went wrong, when step is failed |
{
"vm_uuid": "6f1c2a9e-4b3d-4e8a-9c71-2d5e8f0a1b34",
"from_template_name": "Ubuntu 26.04 LTS",
"to_template_name": "Debian 13",
"step": "done",
"started_at": "2026-11-01T10:05:00+00:00",
"completed_at": "2026-11-01T10:06:12+00:00",
"error": null
}Errors
| Status | When |
|---|---|
401 | No token, or a token that is not valid |
404 | No reinstall of this server is known |
422 | The body or a parameter is not what the operation takes |
Every operation can also answer 401 without a valid token. All errors