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
    • Billing
      • Credit Depletion & Resource Protection
    • SSH Keys
      • Add SSH Keys
      • Manage SSH Keys
      • Connecting to Your VM via SSH
    • 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
  • Balance
    • Get credit balance
      GET
  • Deploy Instance
    • Create a new instance
      POST
  • Pricing
    • Get pricing information
      GET
    • Get pricing information
      POST
  • Instances
    • List instances
    • Delete instance
    • Hibernate instance
    • Reboot instance
    • Restore hibernated instance
    • Start instance
    • Stop instance
    • Toggle public IP for instance
    • Get instance details
    • Get firewalls attached to instance
    • Add instance security rule
    • Remove instance security rule
    • Get instance billing
    • List Instance eligible for snapshot creation
  • SSH Keys
    • List SSH keys
    • Create SSH key
    • Get SSH key
    • Delete SSH key
  • Volumes
    • Attach volumes to instance
    • Detach volumes from instance
    • List volumes
    • Create volume
    • Get volume details
    • Delete volume
    • Clone volume
    • Resize volume
    • Get volume billing
    • List available volume types
  • Scripts
    • List all startup scripts
    • Create a startup script
    • Get startup script details
    • Update a startup script
    • Delete a startup script
    • Delete multiple startup scripts
  • Snapshots
    • Create snapshot
    • List snapshots
    • Get snapshot details
    • Delete snapshot
    • Restore snapshot
    • Get snapshot billing
  • Images
    • List custom images
    • Get image details
    • Delete custom image
    • List OS images
    • Create image from snapshot
    • Get snapshot-image relationship
    • Get snapshot-image relationship list
  • Firewalls
    • List firewalls
    • Get firewall details
    • Attach firewall to instances
    • Delete firewall
    • Remove firewall rule
    • Add firewall rule
    • Create firewall
    • List instances available for firewall attachment
    • Get supported protocols
  • GPU Stocks
    • Get GPU stock availability
  • GPU Specs
    • Get GPU specifications
  • Regions
    • List available regions
  • Schemas
    • AddFirewallRuleRequest
    • APIKeyResponse
    • AddFirewallRuleResponse
    • AddVMSecurityRuleResponse
    • AttachFirewallRequest
    • AggregatedBillingResponse
    • AttachFirewallResponse
    • AttachVolumesRequest
    • AttachVolumesResponse
    • AttachedFirewall
    • BatchSnapshotImageRelationshipResponse
    • Balance
    • Billing
    • ChatCompletionsRequest
    • ChatCompletionsResponse
    • CloneVolumeRequest
    • BillingRecord
    • BillingBreakdown
    • CloneVolumeResponse
    • BillingSummary
    • CreateFirewallRequest
    • CreateFirewallResponse
    • BootSourceEnum
    • CreateImageFromSnapshotRequest
    • BulkDeleteResponse
    • CreateSSHKeyRequest
    • CreateScriptRequest
    • CreateSnapshotRequest
    • CreateSnapshotResponse
    • CreateSSHKeyResponse
    • ComputeBilling
    • CurrencyEnum
    • Data
    • CreditBalanceResponse
    • CreateAPIKeyRequest
    • DeleteFirewallResponse
    • CreateVolumeRequest
    • CreateAPIKeyRequestTierEnum
    • DeleteSnapshotResponse
    • CreateVolumeResponse
    • CreateAPIKeyResponse
    • DeleteVMResponse
    • DetachVolumesRequest
    • DetachVolumesResponse
    • DeploymentRequest
    • DirectionEnum
    • DeploymentResponse
    • CreateSnapshotData
    • EthertypeEnum
    • ErrorResponse
    • FirewallAttachment
    • DeleteVolumeResponse
    • DeleteSSHKeyResponse
    • FirewallEnvironment
    • FirewallResponse
    • FirewallRule
    • FirewallVM
    • DataVolumeBilling
    • GetBatchSnapshotImageRelationshipsRequest
    • GetFirewallDetailsResponse
    • GPUStockConfiguration
    • GPUSpec
    • GetHibernatedVMsResponse
    • GPUStockItem
    • GPUSpecsResponse
    • GetSupportedProtocolsResponse
    • GPUStocksResponse
    • GetVMAttachedFirewallsResponse
    • DeploymentData
    • DeleteAPIKeyResponse
    • GetVolumeTypesResponse
    • HibernateVMResponse
    • HibernationBillingMetrics
    • ListFirewallsResponse
    • ListUserVMsResponse
    • ListVMsResponse
    • DeploymentDataStatusEnum
    • ModelsResponse
    • GetSSHKeysResponse
    • Pagination
    • PricingRequest
    • OSImage
    • Deposit
    • PricingResponse
    • OSImagesResponse
    • DepositStatusEnum
    • Protocol
    • GpuCountEnum
    • FirewallInstance
    • ProtocolEnum
    • Image
    • GpuModelEnum
    • GetVolumeDetailsResponse
    • RebootVMResponse
    • ImageCreateResponse
    • RecentHibernation
    • ImageDeleteResponse
    • GetVolumesWithNextNameResponse
    • RemoveFirewallRuleResponse
    • ImageDetailResponse
    • RemoveVMSecurityRuleResponse
    • Region
    • ImageListResponse
    • ResizeVolumeRequest
    • RegionsResponse
    • Price
    • ResizeVolumeResponse
    • ResourceTypeEnum
    • RestoreSnapshotRequest
    • RestoreSnapshotResponse
    • GetSSHKeyDetailResponse
    • RestoreVMResponse
    • Snapshot
    • SnapshotImageRelationshipResponse
    • GetSnapshotDetailsResponse
    • Specs
    • StartVMResponse
    • GpuBilling
    • StopVMResponse
    • TierEnum
    • UpdateScriptRequest
    • UsageHistoryResponse
    • UsageSummaryResponse
    • RegionEnum
    • UserVM
    • VMDetailsResponse
    • VMFlavor
    • InstanceFeatures
    • VMImage
    • InstanceSpecs
    • VMInstance
    • IpStatusEnum
    • VMResponse
    • SpecsMetadata
    • VMSecurityRule
    • VMSecurityRuleRequest
    • VMStatus
    • VMVolumeAttachment
    • Script
    • ListFirewallInstancesResponse
    • VolumeTypeEnum
    • SSHKeyResponse
    • ScriptListResponse
    • OsVolume
    • ListSnapshotsResponse
    • ListVMsForSnapshotResponse
    • ListAPIKeysResponse
    • PricingRequestVolumeTypeEnum
    • ToggleVMPublicIPResponse
    • PatchedDeposit
    • PatchedTransaction
    • PaymentMethodEnum
    • VolumeBillingRecord
    • VolumeBillingSummary
    • VolumeHourlyBillingResponse
    • SecurityRule
    • ScriptCreateResponse
    • RestoreSnapshotData
    • ScriptDeleteResponse
    • ScriptDetailResponse
    • VolumeResponse
    • ScriptUpdateResponse
    • StatusEnum
    • StorageBilling
    • SnapshotBillingRecord
    • SnapshotBillingResponse
    • SnapshotBillingSummary
    • SnapshotDetail
    • SnapshotListItem
    • SnapshotVMResponse
    • Tier528Enum
    • TokenObtainPair
    • TokenRefresh
    • Transaction
    • VolumeCreate
    • TransactionTypeEnum
    • VolumeCreateVolumeTypeEnum
    • VolumeRate
    • UserProfile
    • VMDetailVolumeAttachment
    • VMOperations
    • VMSpecs
    • VolumeTypeItem
    • VolumeTypesByTier
  1. Volumes

List and View Volumes

Navigate to barrack.ai/volumes to access your volumes. The interface displays volumes organized by status group with search, sort, and region filtering controls.

Volume List Overview#

Layout#

Volumes are displayed as rows in a grouped list, organized into three collapsible status groups:
In Progress — Volumes currently being provisioned
Available — Volumes ready for attachment
Attached — Volumes connected to instances
Each group header shows the volume count and total storage size for that group. Click the group header to collapse or expand it.

Volume Row Information#

Each volume row displays:
Name — Volume display name
Size — Storage capacity in GB
Type — SSD, NVMe, or HDD
Status Badge — Available, Attached, or Creating
Instance Name — Shown for attached volumes (links to attached VM)
VM Status Badge — Shown for attached volumes (e.g., SHUTOFF, ACTIVE)
Bootable Badge — "Boot" indicator for bootable volumes
Action Button — Attach (for available volumes) or Detach (for attached volumes)

Expanded Row Details#

Click any volume row to expand it and view additional details:
Volume ID — Full ID with copy-to-clipboard button
Region — Deployment region
Created — Creation date
Bootable — Yes or No
Action Buttons in Expanded View:
Resize — Expand volume capacity (Advanced Tier only; enabled when volume is Available or Attached)
Clone — Duplicate volume in same region (Advanced Tier only; enabled when Available, or Attached with instance SHUTOFF)
Delete — Remove volume (enabled when volume is Available)

Interface Controls#

Region Dropdown#

Use the region dropdown in the header to filter volumes by region:
CANADA-1 — Legacy Tier
FINLAND-1/2/3 — Advanced Tier (Coming March 2026)
Volume list, group counts, and all controls update automatically when the region changes. Volume names are unique per region (same name can exist in different regions).

Search#

Use the search bar to filter volumes by name or volume ID. Results update in real time as you type. Maximum 30 characters.

Sort#

Use the sort dropdown to order volumes within each group:
Name — Alphabetical order (default)
Size — Largest first
Date — Newest first

Volume Count#

The total number of volumes matching the current region and search filters is displayed next to the sort controls.

Refresh Button#

Reloads volume data to reflect recent changes. Rate limited to 3 consecutive attempts; wait before retrying if limit is reached.

Create Volume Button#

Opens the volume creation modal. Disabled if your profile is incomplete or your account balance is below the minimum. Hover over the disabled button to see the specific requirement.

Pagination#

Each status group paginates independently at 15 volumes per page. Pagination controls appear at the bottom of each group when the group contains more than 15 volumes, showing the current range (e.g., "Showing 1–15 of 42") and page navigation.

Volume Details Modal#

Click the info icon (ℹ️) on any volume row (visible in the expanded row or via the volume card on mobile) to open the details modal.
Details Displayed:
Volume ID, Name, Size, Type
Region and Status
Bootable indicator (Yes/No)
Attached instance name and ID (if attached)
Advanced Tier Operations (FINLAND-1/2/3) — Coming March 2026:
Resize — Expand volume capacity (available when volume is Available or Attached)
Clone — Duplicate volume in same region (available when Available, or Attached with instance SHUTOFF)

Volume Status Reference#

Available#

Volume is provisioned and ready for use. Not attached to any instance.
Available Operations:
Attach to instances
Delete
Clone (advanced tier)
Resize (advanced tier)
Display: Light blue badge

Attached#

Volume is connected to an instance and currently in use.
Available Operations:
Detach (non-bootable volumes only, instance must be SHUTOFF; bootable volumes in CANADA-1 cannot be detached)
Resize (advanced tier)
Clone (advanced tier, instance must be SHUTOFF)
Restricted:
Cannot delete (detach first)
Cannot attach to other instances
Display: Blue badge with instance name shown. VM status badge displayed alongside (e.g., SHUTOFF in green, ACTIVE in gray).

Creating#

Volume is being provisioned. Typically completes within 30 seconds.
Available Operations: None — wait for status to change to Available.
Display: Pulsing blue badge. Appears in the "In Progress" group.
Note: Volume status may take up to 30 seconds to sync after operations. Click Refresh if status appears outdated.

Volume Types#

TypeDescriptionAvailability
SSDStandard solid-state storageCANADA-1 only
NVMeHigh-performance NVMe storageFINLAND-1/2/3 (Coming March 2026)
HDDCost-effective magnetic storageFINLAND-1/2/3 (Coming March 2026)

Bootable Volumes#

Bootable (Yes):
Created from OS image (CANADA-1 only)
Contains operating system installation
Cannot be detached once attached (CANADA-1 only)
Non-Bootable (No):
Standard data volume
Can be attached and detached freely (when instance is SHUTOFF)

Support#

Email Support: [email protected] — Include selected region, browser version, error messages, and screenshot.
Next: Attach Volumes — Connect volumes to instances. Requirements: Volume Available, Instance SHUTOFF, same region.
Previous
Create Volume
Next
Attach Volumes
Built with