Pods API

Shipped today: GET /v1/pods (list), POST /v1/pods/{id}/start, POST /v1/pods/{id}/stop. Lab cost summary lives at GET /v1/costs. Per-pod sub-routes documented below (GET /v1/pods/{id}, /restart, /ssh, /terminate, /pods/costs) are planned, not yet live. Use the web app’s Pods view for SSH and termination today.

Pods are GPU compute instances provisioned on RunPod. They boot with your lab’s environment, run experiments, and tear down when finished. The Pods API gives you full control over the lifecycle, SSH access, and cost monitoring.

Pod Status

Status	Description
`creating`	Pod is being provisioned on RunPod
`running`	Pod is online and executing or idle
`stopped`	Pod has been stopped (can be restarted)
`terminated`	Pod has been permanently terminated

Create a Pod

Provision a new GPU pod.

labId

string

required

Lab this pod belongs to.

gpuType

string

required

GPU type: H200, H100, A100.

gpuCount

number

default:1

Number of GPUs. Multi-GPU pods available for H100 and A100.

maxHours

number

Maximum runtime in hours. Pod auto-terminates after this limit. Omit for no limit (controlled by budget).

image

string

default:"hubify/base:latest"

Docker image for the pod environment.

env

object

Environment variables to set on the pod.

volumeSize

number

default:50

Persistent volume size in GB.

curl -X POST https://www.hubify.com/api/v1/pods \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "j57a8k9m2n3p4q5r",
    "gpuType": "H200",
    "maxHours": 8,
    "env": {
      "COBAYA_PACKAGES": "/workspace/packages",
      "EXPERIMENT_ID": "EXP-054"
    },
    "volumeSize": 100
  }'

const pod = await hubify.pods.create({
  labId: "j57a8k9m2n3p4q5r",
  gpuType: "H200",
  maxHours: 8,
  env: {
    COBAYA_PACKAGES: "/workspace/packages",
    EXPERIMENT_ID: "EXP-054",
  },
  volumeSize: 100,
});

data

object

Show Pod object

_id

string

required

Convex document ID.

labId

string

required

Parent lab ID.

provider

string

required

Always runpod.

podId

string

required

RunPod pod identifier.

gpuType

string

required

GPU type.

status

string

required

Current status.

sshHost

string

SSH hostname (available once running).

sshPort

number

SSH port (available once running).

costPerHour

number

Hourly cost in USD.

createdAt

number

required

Creation timestamp (ms).

List Pods

labId

string

required

Lab ID.

status

string

Filter by status: creating, running, stopped, terminated.

curl "https://www.hubify.com/api/v1/pods?labId=j57a8k9m2n3p4q5r&status=running" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const pods = await hubify.pods.list({
  labId: "j57a8k9m2n3p4q5r",
  status: "running",
});

Get Pod Status

Detailed status including GPU utilization, memory, and idle time.

curl https://www.hubify.com/api/v1/pods/pod_abc123 \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const pod = await hubify.pods.get({ podId: "pod_abc123" });

data

object

Show Detailed pod status

podId

string

required

RunPod pod ID.

status

string

required

Current status.

gpuType

string

required

GPU type.

gpuUtilization

number

Current GPU utilization (0-1).

vramUsedGb

number

Current VRAM usage in GB.

vramTotalGb

number

Total VRAM in GB.

idleMinutes

number

Minutes since last GPU activity.

frozen

boolean

Whether the pod is frozen (budget limit reached).

freezeReason

string

Reason for freeze, if applicable.

uptimeSeconds

number

Total uptime in seconds.

costAccumulated

number

Cost accumulated so far in USD.

sshHost

string

SSH hostname.

sshPort

number

SSH port.

SSH Configuration

Once a pod is running, SSH credentials are available in the pod details.

curl https://www.hubify.com/api/v1/pods/pod_abc123/ssh \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const ssh = await hubify.pods.getSSH({ podId: "pod_abc123" });
// { host: "205.196.19.52", port: 11452, user: "root" }

# Connect via SSH
ssh root@205.196.19.52 -p 11452

Stop a Pod

Stop a running pod. The persistent volume is preserved. The pod can be restarted later.

curl -X POST https://www.hubify.com/api/v1/pods/pod_abc123/stop \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

await hubify.pods.stop({ podId: "pod_abc123" });

Restart a Pod

Restart a stopped pod with the same configuration.

curl -X POST https://www.hubify.com/api/v1/pods/pod_abc123/restart \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

await hubify.pods.restart({ podId: "pod_abc123" });

Terminate a Pod

Permanently terminate a pod. The persistent volume is retained for 7 days, then deleted.

Termination is irreversible. Make sure experiment results have been synced back to the lab before terminating.

curl -X POST https://www.hubify.com/api/v1/pods/pod_abc123/terminate \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

await hubify.pods.terminate({ podId: "pod_abc123" });

GPU Types and Pricing

GPU	VRAM	Cost/hr (approx.)	Best For
H200	141 GB	$4.00	Large MCMC, foundation models, multi-survey sweeps
H100	80 GB	$2.50	Training runs, medium MCMC, anomaly detection
A100	80 GB	$1.50	General GPU compute, smaller models

Prices are approximate and depend on RunPod availability. Actual costs are tracked in the cost_tracking table and visible via the cost endpoints.

Cost Tracking

Get Current Month Costs

curl "https://www.hubify.com/api/v1/pods/costs?labId=j57a8k9m2n3p4q5r&month=current" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const costs = await hubify.pods.getCosts({
  labId: "j57a8k9m2n3p4q5r",
  month: "current",
});

data

object

Show Cost summary

gpuCost

number

Total GPU compute cost in USD.

llmCost

number

Total LLM API cost in USD.

storageCost

number

Storage cost in USD.

totalCost

number

Combined total cost.

gpuHours

number

Total GPU hours consumed.

experimentsRun

number

Experiments run this month.

budgetRemaining

number

Remaining budget in USD.

budgetPercent

number

Percentage of budget used (0-1).

Idle Detection

Hubify monitors GPU utilization and alerts you when pods are sitting idle. This is accessible through the pod status endpoint (the idleMinutes field) and triggers notifications when a configurable threshold is exceeded.

An idle GPU is a violation of the Hubify Labs philosophy. The system will suggest queued experiments to deploy on idle pods, and auto-deploy if you have auto-schedule enabled.

Configure Idle Threshold

PATCH /api/v1/labs/{slug}/settings is planned — not yet shipped. Configure idle thresholds via Settings in the web app. The auto-stop cron (shipped in v1.3.1) uses a default 6-hour threshold.

curl -X PATCH https://www.hubify.com/api/v1/labs/dark-energy/settings \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idleAlertMinutes": 15, "autoScheduleEnabled": true}'

await hubify.labs.updateSettings({
  slug: "dark-energy",
  idleAlertMinutes: 15,
  autoScheduleEnabled: true,
});

Overview

Labs

Data

Compute

Lab Ops

Pods

Pods API

Pod Status

Create a Pod

List Pods

Get Pod Status

SSH Configuration

Stop a Pod

Restart a Pod

Terminate a Pod

GPU Types and Pricing

Cost Tracking

Get Current Month Costs

Idle Detection

Configure Idle Threshold

​Pods API

​Pod Status

​Create a Pod

​List Pods

​Get Pod Status

​SSH Configuration

​Stop a Pod

​Restart a Pod

​Terminate a Pod

​GPU Types and Pricing

​Cost Tracking

​Get Current Month Costs

​Idle Detection

​Configure Idle Threshold

Pods API

Pod Status

Create a Pod

List Pods

Get Pod Status

SSH Configuration

Stop a Pod

Restart a Pod

Terminate a Pod

GPU Types and Pricing

Cost Tracking

Get Current Month Costs

Idle Detection

Configure Idle Threshold