List the snapshots of a VPS
GET /api/v2/vps/{id}/snapshots
Lists the snapshots of a VPS, its snapshot slots and whether a snapshot can be taken or restored now. A snapshot is a quick restore point on the VPS’s own storage, not an offsite backup. Snapshots are deleted 24 hours after they are taken (expiresAt). A snapshot has no ID of its own: use its name as {snapshotId} to restore or delete it. When limits.totalSnapshots is 0, the plan has no snapshot slots. Add slots with snapshotSlots on POST /api/v2/vps/{id}/actions/config. Use backups (POST /api/v2/vps/{id}/backups) for an offsite, longer-term copy. They can take longer to create and restore.
Authentication: An API key with the scope read:services. About keys and scopes
Request
Path parameters
idstringrequiredvps_…).Example
curl "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/snapshots" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The snapshots, the slot limits and the action gates.
{ "data": [ { "displayId": "before-upgrade", "name": "before-upgrade", "description": "Before package upgrade", "createdAt": "2026-04-27T10:00:00.000Z", "expiresAt": "2026-04-28T10:00:00.000Z", "includesMemoryState": false, "parentName": null } ], "available": true, "reason": null, "limits": { "totalSnapshots": 2, "usedSnapshots": 1 }, "actions": { "canCreate": { "allowed": true, "reason": null }, "canRestore": { "allowed": true, "reason": null } }}Response fields
dataarray of objectlimits.usedSnapshots is 0. Read it again before you treat a snapshot as gone.displayIdstringname. Kept for older clients. Use name.namestring{snapshotId}.descriptionstring or nullcreatedAtstring or nullexpiresAtstring or nullcreatedAt.includesMemoryStatebooleanparentNamestring or nullavailablebooleanreasonstring or nulllimitsobjecttotalSnapshotsinteger0 means the plan has no snapshot slots.usedSnapshotsintegeractionsobjectcanCreateobjectPOST /api/v2/vps/{id}/snapshots is allowed now. False without free slots, while another snapshot job runs or its state could not be checked, when the VPS service is not active, or when the key lacks backup:vm.allowedbooleanreasonstring or nullcodestring or nullcanRestoreobjectbackup:vm.allowedbooleanreasonstring or nullcodestring or nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is vps_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |