Create a snapshot of your VM

Create a snapshot of your virtual machine. This is useful for backups or for restoring the server to a previous state. The API returns a jobId used to call GET /api/jobs/{jobId} to track the creation process.

VPS Services Snapshots

Context

Where to get IDs / values

Workflow links

Produces

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Body

required
application/json
description string required · Example: Proxmox med ssh och fail2ban
name string required · Example: full-prox-konfig

Responses

200
data object required
data.jobId string required · Example: snapshot_create-18484-1769373936841
data.message string required · Example: Snapshot creation queued

Human-readable message.

data.name string required · Example: full-prox-konfig
data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/vm/{vmid}/snapshots
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/vm/10000/snapshots" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "full-prox-konfig",
    "description": "Proxmox med ssh och fail2ban"
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "jobId": "snapshot_create-18484-1769373936841",
    "name": "full-prox-konfig",
    "message": "Snapshot creation queued"
  }
}
Request Body Example 1 
{
  "name": "full-prox-konfig",
  "description": "Proxmox med ssh och fail2ban"
}