# Account & catalog

Account & catalog

Your account and API settings, plus locations, OS images and tiers.

GET+PATCH/me

Your account: profile, role, per-user limits, and current wallet balance. GET is not rate-limited. PATCH updates allowedIps, maxServers, and monthlySpendLimit — API-token rotation and webhook URL/secret rotation stay console-only, since they require password re-authentication a Bearer token can't stand in for.

json

{
  "id": "usr_9f2...",
  "email": "[email protected]",
  "username": "you",
  "role": "user",
  "emailVerified": true,
  "allowedIps": null,
  "maxServers": 5,
  "monthlySpendLimit": 100.0,
  "balance": 12.34,
  "billingExempt": false,
  "webhookUrl": "https://your-app.com/webhooks/bashrack",
  "createdAt": "2026-05-30T08:12:00Z"
}

PATCH body — all fields optional: { "allowedIps": ["1.2.3.4"], "maxServers": 10, "monthlySpendLimit": 200 } → returns the updated account (same shape as GET).

GET/locations

List all data-center locations with region codes.

json

[
  { "code": "fra", "city": "Frankfurt", "country": "Germany", "flag": "🇩🇪" },
  { "code": "ams", "city": "Amsterdam", "country": "Netherlands", "flag": "🇳🇱" },
  { "code": "nyc", "city": "New York", "country": "USA", "flag": "🇺🇸" },
  { "code": "lax", "city": "Los Angeles", "country": "USA", "flag": "🇺🇸" },
  { "code": "sgp", "city": "Singapore", "country": "Singapore", "flag": "🇸🇬" },
  { "code": "tyo", "city": "Tokyo", "country": "Japan", "flag": "🇯🇵" }
]

GET/os

List available operating systems. All images support cloud-init.

json

[
  { "id": "ubuntu-24.04", "label": "Ubuntu 24.04 LTS", "family": "linux" },
  { "id": "ubuntu-22.04", "label": "Ubuntu 22.04 LTS", "family": "linux" },
  { "id": "debian-13",    "label": "Debian 13 (Trixie)", "family": "linux" },
  { "id": "debian-12",    "label": "Debian 12 (Bookworm)", "family": "linux" },
  { "id": "rocky-9",      "label": "Rocky Linux 9", "family": "linux" },
  { "id": "almalinux-9", "label": "AlmaLinux 9", "family": "linux" },
  { "id": "fedora-42",   "label": "Fedora 42", "family": "linux" },
  { "id": "alpine-3.20", "label": "Alpine Linux 3.20", "family": "linux" }
]

GET/tiers

List VPS tier categories (shared, dedicated, performance) with pricing multipliers and default specs.

json

[
  {
    "id": "shared",
    "name": "Shared",
    "config": { "cores": 2, "ram": 4, "storageGb": 80, "bandwidth": 1 }
  },
  {
    "id": "dedicated",
    "name": "Dedicated",
    "config": { "cores": 8, "ram": 32, "storageGb": 320, "bandwidth": 10 }
  },
  {
    "id": "performance",
    "name": "Performance",
    "config": { "cores": 16, "ram": 64, "storageGb": 800, "bandwidth": 10, "unmetered": true }
  }
]