Create a new instance

POST

/deploy-server/

Creates and deploys a GPU-accelerated virtual machine instance.

Authentication

All requests require API key authentication. Include your API key in the X-API-Key header.

X-API-Key: sk_your_api_key_here

Tiers

Legacy Tier (Available Now)

Region: CANADA-1

GPUs: RTX-A6000 (

0.59/ h r), L 40 (

1.19/hr), A100-PCIe-80GB (

1.49/ h r), H 100 - PC I e - 80 GB (

1.99/hr), H100-PCIe-NVLink-80GB ($2.29/hr)

Advanced Tier (Coming March 2025)

Regions: FINLAND-1, FINLAND-2, FINLAND-3

GPUs: H100-SXM5-80GB (

2.69/ h r), H 200 - 141 GB (

3.49/hr), B200-180GB (

4.69/ h r), B 300 - 262 GB (

5.89/hr)

Deployment Types

Image-based: Deploy from OS image (requires image_name and ssh_key)

Volume boot: Deploy from existing bootable volume (requires volume_id and boot_from_volume: true)

Validation

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

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

VM instance created successfully

Body

🟠400

🟠401

🟠402

🟠404

🟠413

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/deploy-server/' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gpu_model": "RTX-A6000",
    "gpu_count": 1,
    "region": "CANADA-1",
    "instance_name": "string",
    "image_name": "string",
    "volume_id": "string",
    "boot_from_volume": false,
    "ssh_key": "string",
    "public_ip": true,
    "security_rules": [
        {
            "direction": "ingress",
            "protocol": "tcp",
            "ethertype": "IPv4",
            "port_range_min": 1,
            "port_range_max": 1,
            "remote_ip_prefix": "string"
        }
    ],
    "cloud_init": "string",
    "os_volume": {
        "size": 100
    },
    "existing_volumes": [
        "string"
    ],
    "volumes": [
        {
            "name": "string",
            "size": 100,
            "volume_type": "HDD"
        }
    ],
    "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-A1B2C3D",
        "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 credit balance

Get pricing information

Create a new instance

Authentication#

Tiers#