Restore snapshot

POST

/snapshots/{snapshot_id}/restore/

Creates a new VM instance from a snapshot. The new VM inherits all configurations from the original snapshot including GPU type, storage, and specifications. Billing begins immediately upon successful restoration.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Snapshot restored successfully

Body

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/snapshots//restore/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "new_vm_name": "string"
}'

Response Example

200 - Success - Snapshot Restored

{
    "success": true,
    "message": "Snapshot restored successfully",
    "request_id": "o1p2q3r4",
    "timestamp": "2025-12-11T16:00:00Z",
    "data": {
        "instance_id": "BRK-901234D",
        "vm_name": "restored-prod-vm",
        "ip_address": "192.168.1.100",
        "ip_status": "assigned",
        "billing": {
            "hourly_rate": 2.49,
            "currency": "USD"
        },
        "specs": {
            "gpu_type": "H100-PCIe-NVLink-80GB",
            "gpu_count": 2,
            "ram_gb": 256,
            "vcpus": 32,
            "storage_gb": 500
        },
        "status": "ACTIVE",
        "boot_source": "snapshot",
        "created_at": "2025-12-11T16:00:00Z"
    },
    "snapshot": {
        "id": "BRK-123456S",
        "name": "prod-backup-dec11"
    },
    "tier": "legacy"
}

Delete snapshot

Create snapshot