Create a new instance

POST

/deploy-server/

Creates and deploys a GPU-accelerated virtual machine instance.

Supports image-based deployments (from OS images) and volume boot deployments (from existing volumes).
Available across Legacy tier (CANADA-1) and Advanced tier (Nordic regions).

Validates GPU availability, account balance, and resource limits before deployment.
Returns instance details with billing breakdown and hardware specifications.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

VM instance created successfully

Body

🟠400

🟠401

🟠402

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/deploy-server/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gpu_model": "RTX-A6000",
    "gpu_count": 1,
    "region": "FINLAND-1",
    "instance_name": "string",
    "image_name": "string",
    "volume_id": "string",
    "boot_from_volume": false,
    "ssh_key": "string",
    "public_ip": true,
    "security_rules": [
        {
            "property1": null,
            "property2": null
        }
    ],
    "cloud_init": "string",
    "os_volume": {
        "property1": null,
        "property2": null
    },
    "existing_volumes": [
        "string"
    ],
    "volumes": [
        {
            "property1": null,
            "property2": null
        }
    ],
    "script_id": "string"
}'

Response Example

201 - Advanced Tier Image Deployment

{
    "success": true,
    "message": "VM deployed successfully",
    "request_id": "a1b2c3d4",
    "timestamp": "2025-01-15T10:30:00Z",
    "data": {
        "instance_id": "BRK-A1B2C3VM",
        "vm_name": "barrack-h100s-xyz",
        "region": "FINLAND-1",
        "ip_address": null,
        "ip_status": "pending",
        "billing": {
            "breakdown": {
                "compute": {
                    "gpu": {
                        "model": "H100-SXM5-80GB",
                        "count": 4,
                        "hourly_rate": 9.96
                    }
                },
                "storage": {
                    "os_volume": {
                        "size_gb": 100,
                        "type": "NVMe",
                        "hourly_rate": 0.0293
                    },
                    "data_volumes": [],
                    "data_volumes_total": 0
                }
            },
            "total_hourly_rate": 9.9893,
            "currency": "USD"
        },
        "specs": {
            "gpu_type": "H100-SXM5-80GB",
            "gpu_count": 4,
            "ram_gb": 740,
            "vcpus": 176,
            "storage_gb": 100
        },
        "status": "CREATING",
        "boot_source": "image",
        "operating_system": "Ubuntu 24.04 + CUDA 12.8 Open + Docker",
        "features": {
            "startup_script_configured": false
        },
        "created_at": "2025-01-15T10:30:00Z"
    },
    "tier": "advanced"
}

Get pricing information

List instances