Create volume

POST

/volumes/

Creates a new storage volume with specified size and type. Bootable volumes can be created with OS images in supported regions. Minimum volume size is 100GB.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Body

🟠400

🟠401

🟠402

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/volumes/' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "region": "string",
    "size": 100,
    "volume_type": "string",
    "image_name": "string"
}'

Response Example

200 - Success Response

{
    "success": true,
    "message": "Volume created successfully",
    "volume": {
        "id": "BRK-234567V",
        "name": "data-storage",
        "size": 200,
        "region": "FINLAND-1",
        "tier": "advanced",
        "volume_type": "NVMe",
        "status": "creating",
        "bootable": false,
        "created_at": "2025-12-11T14:25:00Z"
    },
    "tier": "advanced"
}

List volumes

Get volume details