Plan change status

GET/api/v1/vms/{vm_uuid}/resize/status

How the last plan change went. Kept for 10 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/resize/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}/resize/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}/resize/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_class_name	string, optional	Plan before
to_class_name	string, optional	Plan after
needs_restart	booleanrequired	The server restarts: the vCPU or memory change. Shared to dedicated of the same size does not restart it
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_class_name": "basic-4g",
  "to_class_name": "basic-4g-dedicated",
  "needs_restart": false,
  "step": "done",
  "started_at": "2026-11-01T10:02:11+00:00",
  "completed_at": "2026-11-01T10:02:19+00:00",
  "error": null
}

Errors

Status	When
`401`	No token, or a token that is not valid
`404`	No plan change 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