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

Resize Volume

Resize Volumes#

Resize volumes to increase their storage capacity. Resizing expands an existing volume's size without data loss.

Prerequisites#

Before resizing, ensure you meet the general volume prerequisites.
Resize-Specific Requirements:
Volume in advanced tier region (FINLAND-1/2/3, ICELAND-1)
Volume status: Available OR Attached (can resize while in use)
New size must be larger than current size (minimum +1 GB)
Volume type cannot be changed during resize

Resize Configuration#

PropertyBehaviorLimits
Current SizeRead-only displayShows current provisioned size
New SizeMust be largerMin: current + 1 GB
Max SizeVaries by typeNVMe: 10,000 GB
HDD: 16,000 GB
Volume TypeUnchangedNVMe stays NVMe, HDD stays HDD
RegionUnchangedCannot move regions

Resizing a Volume#

Step 1: Select Volume#

1
Navigate to Volumes
Go to barrack.ai/volumes
2
Select Region
Use region dropdown - volume must be in advanced tier
3
Open Volume Details
Click info icon (ℹ️) on volume card

Step 2: Initiate Resize#

1.
Click "Resize" button in Advanced Operations section
2.
Resize modal opens showing:
Volume name (read-only)
Current size: {current_size} GB
Volume type badge (NVMe/HDD, read-only)
New size input field

Step 3: Configure New Size#

Enter New Size:
Type new size in GB. Use controls:
↑ Arrow: Increase by 100 GB
↓ Arrow: Decrease by 100 GB
Direct typing: Enter exact size
Size Requirements:
Must exceed current size
Cannot exceed maximum for type
Whole numbers only
Visual Feedback:
Valid: Normal border
Invalid: Red border with error

Step 4: Review & Confirm#

Modal displays updated pricing:
Per GB rate for volume type
Total monthly cost for new size
Currency based on account
Click "Resize Volume" to proceed.
Processing Time: 1-3 minutes typically

Step 5: Verify Resize#

After completion:
Size shows new value in volume list
Status unchanged (Available/Attached)
Billing reflects new size immediately
View Validation Checks
The system validates before proceeding:
Volume Checks:
Exists and belongs to your account
Status is Available or Attached (not Creating/Error)
Located in advanced tier region
Size Validation:
New size > current size
New size ≤ maximum for type
Valid integer value
Account Status:
Sufficient credits for increased cost
Profile complete with minimum balance

Post-Resize Status#

Updated Properties:
Size reflects new value
Billing adjusted immediately
Capacity increased
Unchanged Properties:
Volume status (Available/Attached)
Volume type (NVMe/HDD)
Region, name, ID
Attached instance (if any)
All existing data preserved

Troubleshooting#

Resize-Specific Errors#

Error: New size must be larger than current size
Error: Size cannot exceed maximum
Error: Volume can only be resized when attached or available
Error: Resize only supported for advanced tier regions
Resize Button Disabled

Common Errors#

For authentication, credits, profile, and session errors, see Common Volume Errors.

Pricing#

Resized volumes use same per-GB rates:
Advanced Tier Pricing:
TypeUSDEURINR
NVMe$0.30/GB/mo€0.35/GB/mo₹30/GB/mo
HDD$0.08/GB/mo€0.10/GB/mo₹8/GB/mo
Billing:
Immediate adjustment to new size
Charged hourly for total new size
Old size billing stops, new size starts
Examples:
500GB NVMe → 1000GB:
Old: 500 × $0.30 = $150/mo
New: 1000 × $0.30 = $300/mo
Increase: +$150/mo

2000GB HDD → 5000GB:
Old: 2000 × $0.08 = $160/mo
New: 5000 × $0.08 = $400/mo
Increase: +$240/mo
Resize Best Practices
Before Resizing:
Verify current usage and requirements
Calculate required new size
Ensure sufficient credits for increase
After Resizing:
Verify new size in volumes list
Confirm billing reflects new rate
Update documentation

Next Steps#

1
Verify Resize
Confirm size updated and status unchanged
2
Monitor Billing
Check credits reflect new rate

Support#

Email Support
Include: volume ID/name, current/attempted size, error messages, region
Clone Volumes
Create copy with different type. Advanced regions only.
Previous
Clone Volumes
Next
Delete Volume
Built with