Barrack API Documentation
Snapshot
Copy Page
Barrack API Documentation
Platform Documentation
Getting Started
Authentication & Access
Account Management
API Keys
GPU Models
Regions
Instance
OS Images
Bootsource Management
Deploy Instance
Instance Management
Hibernation
View Instances
SSH Keys
Add SSH Keys
Manage SSH Keys
Volumes
Overview
Create Volume
List and View Volumes
Attach Volumes
Detach Volumes
Clone Volumes
Resize Volume
Delete Volume
Advanced Configurations
Network And Security
Cloudinit Script
Startup Script
Firewall
Manage Firewall
Rules and Attachment
Snapshot
Overview
Manage Snapshots
Restore Snapshots
Custom Images
Overview
Create and Manage Images
dashboard
"Dashboard Overview"
"VM Management"
AI Chat
AI Chat
Balance
Get credit balance
GET
GPU Stocks
Get GPU stock availability
GET
GPU Specs
Get GPU specifications
GET
Regions
List available regions
GET
Pricing
Get pricing information
GET
Get pricing information
POST
Deploy Instance
Create a new instance
Instance management
List instances
Get instance details
Get instance billing
Start instance
Stop instance
Reboot instance
Hibernate instance
Restore hibernated instance
Toggle public IP for instance
Add instance security rule
Remove instance security rule
Delete instance
OS Images
List OS images
SSH Keys
List SSH keys
Get SSH key
Create SSH key
Delete SSH key
Volumes
List volumes
Create volume
Get volume details
Delete volume
Resize volume
Clone volume
Attach volumes to instance
Detach volumes from instance
List available volume types
Get volume billing
Firewalls
List firewalls
Get firewall details
Get supported protocols
Get firewalls attached to instance
List instances available for firewall attachment
Create firewall
Delete firewall
Add firewall rule
Remove firewall rule
Attach firewall to instances
Scripts
List all startup scripts
Get startup script details
Create a startup script
Update a startup script
Delete a startup script
Delete multiple startup scripts
Snapshots
List snapshots
Get snapshot details
List Instance eligible for snapshot creation
Get snapshot billing
Create snapshot
Delete snapshot
Restore snapshot
Images
List custom images
Get image details
Create image from snapshot
Delete custom image
Get snapshot-image relationship
Get snapshot-image relationship list
AI Chat
Get available AI models
Chat with AI
Get AI usage summary
Get AI usage history
Schemas
AITransaction
AddFirewallRuleRequest
AddFirewallRuleResponse
AddVMSecurityRuleResponse
AttachFirewallRequest
AggregatedBillingResponse
AttachFirewallResponse
AttachVolumesRequest
AttachVolumesResponse
AttachedFirewall
BatchSnapshotImageRelationshipResponse
Balance
Billing
ChatCompletionsRequest
ChatCompletionsResponse
CloneVolumeRequest
BillingRecord
CloneVolumeResponse
BillingSummary
CreateFirewallRequest
CreateFirewallResponse
CreateImageFromSnapshotRequest
CreateSSHKeyRequest
CreateScriptRequest
CreateSnapshotRequest
CreateSnapshotResponse
CreateSSHKeyResponse
CurrencyEnum
Data
CreditBalanceResponse
DeleteFirewallResponse
CreateVolumeRequest
DeleteSnapshotResponse
CreateVolumeResponse
DeleteVMResponse
DetachVolumesRequest
DetachVolumesResponse
DeploymentRequest
DirectionEnum
DeploymentResponse
EthertypeEnum
ErrorResponse
FirewallAttachment
DeleteVolumeResponse
DeleteSSHKeyResponse
FirewallEnvironment
FirewallResponse
FirewallRule
FirewallVM
GetBatchSnapshotImageRelationshipsRequest
GetFirewallDetailsResponse
GPUStockConfiguration
GPUSpec
GetHibernatedVMsResponse
GPUStockItem
GPUSpecsResponse
GetSupportedProtocolsResponse
GPUStocksResponse
GetVMAttachedFirewallsResponse
GetVolumeTypesResponse
HibernateVMResponse
HibernationBillingMetrics
ListFirewallsResponse
ListUserVMsResponse
ListVMsResponse
ModelsResponse
GetSSHKeysResponse
Pagination
PricingRequest
OSImage
PricingResponse
OSImagesResponse
Protocol
GpuCountEnum
ProtocolEnum
Image
GpuModelEnum
GetVolumeDetailsResponse
RebootVMResponse
ImageCreateResponse
RecentHibernation
ImageDeleteResponse
GetVolumesWithNextNameResponse
RemoveFirewallRuleResponse
ImageDetailResponse
RemoveVMSecurityRuleResponse
Region
ImageListResponse
ResizeVolumeRequest
RegionsResponse
Price
ResizeVolumeResponse
ResourceTypeEnum
RestoreSnapshotRequest
RestoreSnapshotResponse
RestoreVMResponse
Snapshot
SnapshotImageRelationshipResponse
Specs
StartVMResponse
StopVMResponse
TierEnum
UpdateScriptRequest
UsageHistoryResponse
UsageSummaryResponse
RegionEnum
UserVM
VMDetailsResponse
VMFlavor
VMImage
VMInstance
VMResponse
SpecsMetadata
VMSecurityRule
VMSecurityRuleRequest
VMStatus
VMVolumeAttachment
Script
VolumeTypeEnum
SSHKeyResponse
ScriptListResponse
ToggleVMPublicIPResponse
VolumeBillingRecord
VolumeBillingSummary
VolumeHourlyBillingResponse
VolumeResponse
Snapshot
Copy Page
Restore Snapshots
Restoring Snapshots
#
Restore snapshots to create new instances with identical configurations. The restore operation deploys a new instance from snapshot data, preserving all settings and disk contents.
Account Requirements
#
Before restoring snapshots, verify these requirements:
Profile Completion
Required Fields:
Complete at
barrack.ai/account
Full name
Billing address
Postal code
Country
Minimum Balance
Credit Requirements:
Maintain minimum balance:
US Dollar:
$1.00 minimum
Euro:
€1.00 minimum
Indian Rupee:
₹100.00 minimum
Snapshot Requirements
#
Snapshot Status
Region Compatibility
Layer 2 Validation
Restore Process
#
1
Select Snapshot
Click
Restore
on the snapshot card
2
Review Snapshot Information
Restore modal displays complete snapshot details:
Snapshot name and storage size
Source instance name and region
Creation timestamp and current status
CPU, RAM, GPU, and disk configuration
3
Enter New Instance Name
Provide a unique name for the new instance
Length: 2-30 characters
Must be unique across your instances
See naming rules in Configuration Errors section
4
Confirm Restore
Click
Restore Snapshot
to begin deployment
What Happens:
New instance created from snapshot
Instance ID assigned (BRK-XXXXXXD format)
IP address allocation begins
Billing starts immediately
Instance boots into ACTIVE state
Full disk contents restored
5
Access New Instance
Navigate to
Instances
page to view the restored instance
Instance shows:
New instance ID and name you provided
IP address (pending → assigned)
Billing status: Active
Boot source: snapshot
Region: CANADA-1
Post-Restore Information
#
What Gets Restored
#
Preserved from snapshot:
Complete disk contents and file system
Instance configuration (CPU, RAM, GPU)
Storage capacity and disk type
Network configuration and SSH keys
Installed software and data
Operating system state
New for restored instance:
Instance ID (new BRK-XXXXXXD)
Instance name (you provide)
IP address (newly assigned)
Billing history (starts fresh)
Creation timestamp
Instance Configuration
#
The restored instance inherits all specifications from the snapshot:
Compute Resources
Matches Original:
GPU Type: Identical to snapshot
GPU Count: Same as original
vCPUs: Identical allocation
RAM: Same memory capacity (GB)
Storage
Disk Configuration:
Storage GB: Matches snapshot size
Disk Type: Same as original
Data: Complete disk contents restored
File system: Preserved from snapshot
Billing Details
#
Immediate Billing
Charges Begin:
Start time: Restore completion
Billing plan: per-minute
Currency: Matches your account
Rate: Based on instance specifications
Ongoing Costs
Billing Continues:
While instance is ACTIVE
Separate from snapshot storage costs
Deducted from account balance
Visible in billing history
Snapshot-Image Relationships
#
Understanding how snapshots and images interact:
Image Creation
Image Benefits
Image Deletion Effects
Configuration Errors
#
Duplicate Instance Name
Snapshot Not Available
Insufficient Credits
Profile Incomplete
Instance Not Found After Restore
Snapshot Deleted During Restore
Invalid Snapshot Status
Invalid Instance Name Format
Support Resources
#
Email Support
Contact Support Team
Email:
[email protected]
Include in your message:
Snapshot ID
Snapshot name
New instance name attempted
Error messages received
Steps already tried
Managing Snapshots
View and Manage Your Snapshots
Learn how to:
View snapshot details
Monitor storage costs
Delete unused snapshots
Organize your backups
Previous
Manage Snapshots
Next
Overview