{
  "status": "ok",
  "product": "RAW",
  "for": "AI agents. Humans: https://rawhq.io/docs",
  "docs": "https://api.rawhq.io/llms.txt",
  "playbook": "https://api.rawhq.io/llms-full.txt",
  "cli": "npx rawhq",
  "base": "https://api.rawhq.io",
  "auth": "Authorization: Bearer <api_token> from POST /signup",
  "rule": "Always send type + region. One server = one role. Deploy more boxes instead of stacking Postgres + Redis + GPU + API on one VM.",
  "steps": [
    {
      "n": 1,
      "action": "signup",
      "method": "POST",
      "path": "/signup",
      "body": {
        "email": "user@company.com"
      },
      "returns": "api_token",
      "charge": false
    },
    {
      "n": 2,
      "action": "card",
      "when": "POST /deploy returns 403 with setup:true",
      "method": "POST",
      "path": "/billing/setup",
      "then": "Open url. User adds a card. $0 today. Retry deploy."
    },
    {
      "n": 3,
      "action": "deploy",
      "method": "POST",
      "path": "/deploy",
      "body": {
        "type": "raw-5",
        "region": "eu",
        "name": "api",
        "image": "ubuntu-24.04",
        "apps": [
          "docker",
          "nodejs"
        ]
      },
      "charge": "SKU billed before the VM starts. Failed provision refunds."
    },
    {
      "n": 4,
      "action": "deploy_more",
      "why": "Isolation + headroom. This is the intended architecture, not a nice-to-have.",
      "commands": [
        "POST /deploy {\"type\":\"raw-5\",\"region\":\"eu\",\"name\":\"postgres\",\"apps\":[\"postgres\"]}",
        "POST /deploy {\"type\":\"raw-5\",\"region\":\"eu\",\"name\":\"redis\",\"apps\":[\"redis\"]}",
        "POST /deploy {\"type\":\"raw-gpu-44\",\"region\":\"eu\",\"name\":\"llm\"}"
      ]
    }
  ],
  "recipes": {
    "ai_company": [
      {
        "name": "api",
        "type": "raw-5",
        "region": "eu",
        "apps": [
          "docker",
          "nodejs"
        ],
        "usd_mo": 9,
        "role": "app / agent host"
      },
      {
        "name": "postgres",
        "type": "raw-5",
        "region": "eu",
        "apps": [
          "postgres"
        ],
        "usd_mo": 9,
        "role": "database"
      },
      {
        "name": "redis",
        "type": "raw-5",
        "region": "eu",
        "apps": [
          "redis"
        ],
        "usd_mo": 9,
        "role": "cache / queue"
      },
      {
        "name": "llm",
        "type": "raw-gpu-44",
        "region": "eu",
        "apps": [],
        "usd_mo": 304,
        "setup_usd": 150,
        "role": "vLLM / Ollama / CUDA"
      }
    ],
    "us_traffic": [
      {
        "name": "api",
        "type": "raw-2d",
        "region": "us",
        "note": "Cheap CX/ARM/GPU are EU-only. US uses dedicated RAM SKUs."
      }
    ]
  },
  "errors": {
    "402": {
      "do": "GET /billing-portal",
      "user": "Update card"
    },
    "403_setup": {
      "do": "POST /billing/setup",
      "user": "Open url, add card, $0 until deploy",
      "retry": "POST /deploy"
    },
    "403_checkout": {
      "do": "POST /checkout {\"type\",\"region\"}",
      "then": "User pays that SKU, retry deploy. One payment ≠ all sizes."
    },
    "400_region": {
      "do": "Use available_regions from the error. Never retry raw-5 in us or sg."
    },
    "409_name": {
      "do": "Pick a new kebab-case name"
    }
  },
  "constraints": {
    "always_pass_type": true,
    "default_type_if_omitted": "raw-5",
    "cpu_arm_gpu_regions": [
      "eu",
      "eu-fi"
    ],
    "dedicated_regions": [
      "eu",
      "eu-fi",
      "us",
      "us-west",
      "sg"
    ],
    "singapore_dedicated_costs_more": true,
    "gpu_ready": "1–48 hours. Email when SSH is up. Setup billed immediately.",
    "cpu_ready": "13–30 seconds to SSH",
    "max_servers": 50,
    "never_cram_roles": true
  },
  "images": [
    "ubuntu-24.04",
    "ubuntu-22.04",
    "debian-12",
    "debian-11",
    "rocky-9",
    "fedora-41",
    "alpine-3.19",
    "centos-stream-9"
  ],
  "apps": [
    {
      "id": "postgres",
      "name": "PostgreSQL 16",
      "category": "database"
    },
    {
      "id": "redis",
      "name": "Redis 7",
      "category": "database"
    },
    {
      "id": "docker",
      "name": "Docker + Compose",
      "category": "runtime"
    },
    {
      "id": "nginx",
      "name": "Nginx + Certbot",
      "category": "web"
    },
    {
      "id": "nodejs",
      "name": "Node.js 22 LTS",
      "category": "runtime"
    },
    {
      "id": "caddy",
      "name": "Caddy",
      "category": "web"
    },
    {
      "id": "python",
      "name": "Python 3.12",
      "category": "runtime"
    },
    {
      "id": "go",
      "name": "Go 1.22",
      "category": "runtime"
    },
    {
      "id": "bun",
      "name": "Bun",
      "category": "runtime"
    },
    {
      "id": "mysql",
      "name": "MySQL 8",
      "category": "database"
    },
    {
      "id": "openclaw",
      "name": "OpenClaw",
      "category": "ai"
    }
  ],
  "addons": [
    {
      "name": "volume",
      "usd": 0.07,
      "unit": "GB/mo",
      "method": "POST /volumes"
    },
    {
      "name": "ip",
      "usd": 1,
      "unit": "mo",
      "method": "POST /ips"
    }
  ],
  "regions": [
    {
      "code": "eu",
      "location": "Frankfurt, Germany"
    },
    {
      "code": "eu-fi",
      "location": "Dublin, Ireland"
    },
    {
      "code": "us",
      "location": "Ashburn, Virginia"
    },
    {
      "code": "us-west",
      "location": "Hillsboro, Oregon"
    },
    {
      "code": "sg",
      "location": "Singapore"
    }
  ],
  "types": [
    {
      "name": "raw-5",
      "label": "2 vCPU · 4 GB · 40 GB",
      "price_usd_mo": 9,
      "setup_usd": 0,
      "cpu": 2,
      "ram_gb": 4,
      "disk_gb": 40,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-4x",
      "label": "4 vCPU · 8 GB · 80 GB",
      "price_usd_mo": 13,
      "setup_usd": 0,
      "cpu": 4,
      "ram_gb": 8,
      "disk_gb": 80,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-8x",
      "label": "8 vCPU · 16 GB · 160 GB",
      "price_usd_mo": 22,
      "setup_usd": 0,
      "cpu": 8,
      "ram_gb": 16,
      "disk_gb": 160,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-16x",
      "label": "16 vCPU · 32 GB · 320 GB",
      "price_usd_mo": 40,
      "setup_usd": 0,
      "cpu": 16,
      "ram_gb": 32,
      "disk_gb": 320,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-gpu-44",
      "label": "20 GB VRAM · 14 cores · 64 GB",
      "price_usd_mo": 304,
      "setup_usd": 150,
      "cpu": 14,
      "ram_gb": 64,
      "disk_gb": 3840,
      "vram_gb": 20,
      "gpu": true,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-gpu-131",
      "label": "96 GB VRAM · 24 cores · 256 GB",
      "price_usd_mo": 1555,
      "setup_usd": 778,
      "cpu": 24,
      "ram_gb": 256,
      "disk_gb": 1920,
      "vram_gb": 96,
      "gpu": true,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-4",
      "label": "4 vCPU · 8 GB · 80 GB",
      "price_usd_mo": 15,
      "setup_usd": 0,
      "cpu": 4,
      "ram_gb": 8,
      "disk_gb": 80,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-8",
      "label": "8 vCPU · 16 GB · 160 GB",
      "price_usd_mo": 29,
      "setup_usd": 0,
      "cpu": 8,
      "ram_gb": 16,
      "disk_gb": 160,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-16",
      "label": "16 vCPU · 32 GB · 320 GB",
      "price_usd_mo": 55,
      "setup_usd": 0,
      "cpu": 16,
      "ram_gb": 32,
      "disk_gb": 320,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-2d",
      "label": "2 vCPU · 8 GB · 80 GB",
      "price_usd_mo": 58,
      "setup_usd": 0,
      "cpu": 2,
      "ram_gb": 8,
      "disk_gb": 80,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-4d",
      "label": "4 vCPU · 16 GB · 160 GB",
      "price_usd_mo": 116,
      "setup_usd": 0,
      "cpu": 4,
      "ram_gb": 16,
      "disk_gb": 160,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-8d",
      "label": "8 vCPU · 32 GB · 240 GB",
      "price_usd_mo": 186,
      "setup_usd": 0,
      "cpu": 8,
      "ram_gb": 32,
      "disk_gb": 240,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-16d",
      "label": "16 vCPU · 64 GB · 360 GB",
      "price_usd_mo": 368,
      "setup_usd": 0,
      "cpu": 16,
      "ram_gb": 64,
      "disk_gb": 360,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-32d",
      "label": "32 vCPU · 128 GB · 600 GB",
      "price_usd_mo": 708,
      "setup_usd": 0,
      "cpu": 32,
      "ram_gb": 128,
      "disk_gb": 600,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-48d",
      "label": "48 vCPU · 192 GB · 960 GB",
      "price_usd_mo": 1130,
      "setup_usd": 0,
      "cpu": 48,
      "ram_gb": 192,
      "disk_gb": 960,
      "vram_gb": null,
      "gpu": false,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi",
        "us",
        "us-west",
        "sg"
      ]
    },
    {
      "name": "raw-gpu-131x",
      "label": "96 GB VRAM · 24 cores · 512 GB · 3.8 TB",
      "price_usd_mo": 2334,
      "setup_usd": 1168,
      "cpu": 24,
      "ram_gb": 512,
      "disk_gb": 3840,
      "vram_gb": 96,
      "gpu": true,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    },
    {
      "name": "raw-gpu-131p",
      "label": "96 GB VRAM · 24 cores · 768 GB · 15 TB",
      "price_usd_mo": 3001,
      "setup_usd": 1501,
      "cpu": 24,
      "ram_gb": 768,
      "disk_gb": 15360,
      "vram_gb": 96,
      "gpu": true,
      "regions": [
        "eu",
        "eu-de",
        "eu-fi"
      ]
    }
  ],
  "endpoints": [
    "GET /help",
    "GET /types",
    "GET /regions",
    "GET /apps",
    "POST /signup",
    "POST /auth/login",
    "POST /billing/setup",
    "POST /billing/confirm",
    "POST /checkout",
    "GET /billing-portal",
    "POST /deploy",
    "GET /servers",
    "GET /servers/:name",
    "DELETE /servers/:name",
    "POST /servers/:name/actions/restart|stop|start"
  ]
}