VPS Provisioning API
Region-routing middleware for cloud VPS provisioning. Currently wired to Hetzner Cloud for select regions; other regions are rejected cleanly until their providers are integrated.
Base URL:
Auth: Admin API key + IP allowlist + owner headers
Rate limit: 200 req/min per key, 100 req/s DoS guard, 10 failures/min IP block
https://vps.luveedu.cloud/apiAuth: Admin API key + IP allowlist + owner headers
Rate limit: 200 req/min per key, 100 req/s DoS guard, 10 failures/min IP block
Regions
Pick a friendly region name when creating a server. The middleware routes to the right upstream provider.
us-1
Hetzner · ash
us-2
Hetzner · hil
germany
Hetzner · fsn1
finland
Hetzner · hel1
singapore
Hetzner · sin
uk
unwired
japan
unwired
australia
unwired
Endpoints
GET/locationsList regions + provider routing
GET/server-typesList available server types
GET/imagesList installable OS images
GET/ssh-keysList SSH keys
POST/createCreate a new VPS
GET/listList your VPS instances
GET/status/{id}Get VPS details
PUT/update/{id}Rename / relabel / set protection
DELETE/delete/{id}Delete a VPS
POST/poweron/{id}Power on
POST/poweroff/{id}Hard power off
POST/reboot/{id}Soft reboot (ACPI)
POST/shutdown/{id}Graceful shutdown
POST/reset-password/{id}Reset root password
POST/rebuild/{id}Rebuild from image
GET/metrics/{id}CPU / disk / network metrics
GET/action/{id}Poll async action status
POST/volume/createCreate a block-storage volume
GET/volume/listList your volumes
DELETE/volume/delete/{id}Delete a volume
GET/syncBulk export for frontend
GET/healthPublic health probe
Documentation
Full API reference with request/response examples, error codes, and integration guide: