Barrack API Documentation
Volumes
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
Pricing
Get pricing information
Get pricing information
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
Volumes
Copy Page
Create Volume
Create Volume
#
Navigate to
barrack.ai/volumes
and click
Create Volume
to open the volume creation modal. If the button is disabled, hover over it to see the specific requirement (incomplete profile or insufficient balance).
Requirements
#
Profile Complete
Complete your profile at
barrack.ai/account
with billing information (name, address, postal code, country).
Minimum Balance
Account balance must meet minimum:
USD:
$1.00
EUR:
€1.00
INR:
₹100.00
Region Capabilities
#
Legacy Tier (CANADA-1)
Volume Type:
SSD only
Size Range:
100 GB - 102,400 GB
Bootable Volumes:
✅ Supported (Ubuntu)
Clone/Resize:
❌ Not available
Pricing:
$0.10/GB/month
Advanced Tier (Nordic)
Regions:
FINLAND-1/2/3, ICELAND-1
Volume Types:
NVMe or HDD
Size Range:
NVMe (100-10,000 GB), HDD (100-16,000 GB)
Bootable Volumes:
❌ Not supported
Clone/Resize:
✅ Available
Pricing:
NVMe
0.30/
GB
/
m
o
n
t
h
,
HDD
0.08/GB/month
Creating a Volume
#
Step 1: Select Region
#
Choose your deployment region from the dropdown:
CANADA-1
- Legacy Tier (bootable volumes, SSD)
FINLAND-1/2/3, ICELAND-1
- Advanced Tier (clone/resize, NVMe/HDD)
Step 2: Enter Volume Name
#
Requirements:
Length: 3-30 characters
Allowed: Letters, numbers, hyphens (-), underscores (_)
Cannot start or end with hyphen/underscore
Must be unique within selected region
Examples:
✅ Valid:
data-volume-1
,
backup_storage
,
prod_db_vol
❌ Invalid:
vo
(too short),
-data
(starts with hyphen),
my volume
(contains space)
Step 3: Select Volume Type & Size
#
Legacy Tier (CANADA-1)
Advanced Tier (Nordic)
Volume Type:
SSD (automatically selected)
Size Range:
100 GB - 102,400 GB
Pricing:
$0.10/GB/month (USD)
€0.10/GB/month (EUR)
₹10/GB/month (INR)
Size Input:
Enter numeric value (GB suffix is automatic)
Use up/down arrows or keyboard ↑/↓ to adjust by 100 GB
Real-time pricing updates as you adjust size
Step 4: Configure Bootable Volume (CANADA-1 Only)
#
To create a bootable volume:
1.
Enable "Make Bootable" toggle
2.
Select Ubuntu image from dropdown
3.
Image selection is required when bootable is enabled
Bootable Volume Restrictions:
Cannot be detached once attached to an instance
Attachment is permanent for instance lifetime
Cannot be converted to non-bootable after creation
Non-Bootable Volumes:
Can be attached and detached freely (when instance is SHUTOFF)
Available in all regions
No OS image required
Step 5: Create Volume
#
Click
Create
to submit. Volume creation typically completes within 30 seconds.
After Creation:
Volume appears in volumes list with "Available" status
Billing begins immediately (hourly rate based on size)
Volume is ready for attachment to instances
Troubleshooting
#
Profile incomplete error
Insufficient credits error
Duplicate name error
Invalid volume size error
Invalid volume type error
Bootable volumes not supported error
OS image required error
Support
#
Email Support
Contact support for volume creation assistance
Include: Volume name, region, error messages
Next: Attach Volume
Connect your volume to an instance
Requirements: Volume Available, Instance SHUTOFF
Previous
Overview
Next
List and View Volumes