Create a backup of a virtual server (VM)

Initiate a manual backup of your VM. Returns a `jobId` that you can use to track the backup process status via `GET /api/jobs/{jobId}`.

VPS Services Backups

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
fleecing object required
mode string required · Example: snapshot

Responses

200
data object required
data.jobId string required · Example: backup-17910-1769734006476
data.message string required · Example: Backup job queued successfully

Human-readable message.

data.mode string required · Example: snapshot
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}/backups
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/vm/10000/backups" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "snapshot",
    "fleecing": {
      "enabled": true,
      "storage": "fleecing-storage"
    }
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "jobId": "backup-17910-1769734006476",
    "mode": "snapshot",
    "message": "Backup job queued successfully"
  }
}
Request Body Example 1 
{
  "mode": "snapshot",
  "fleecing": {
    "enabled": true,
    "storage": "fleecing-storage"
  }
}