Barrack API Documentation
  1. Volumes
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
  1. Volumes

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/month,HDD0.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
Built with