Zeabur Dedicated Server API Guide

Zeabur exposes a GraphQL API for renting and managing dedicated servers across multiple cloud providers.

Quick Start

All requests go to the Zeabur GraphQL endpoint with your API token in the Authorization header.

1. Discover Available Servers

List Providers

 query {
 dedicatedServerProviders {
 code
 name
 icon
 canRefund
 }
 }

Supported providers: DIGITALOCEAN, HETZNER, TENCENT, ALIYUN, VOLCENGINE, LINODE, LIGHTSAIL

List Regions

 query {
 dedicatedServerRegions(provider: "HETZNER") {
 key
 name
 }
 }

List Plans

 query {
 dedicatedServerPlans(provider: "HETZNER", region: "fsn1") {
 name
 cpu
 memory
 disk
 egress
 price # monthly price in USD cents
 gpu
 available
 }
 }

2. Rent a Server

 mutation {
 rentServer(
 provider: "HETZNER"
 region: "fsn1"
 plan: "cpx22"
 ) {
 _id
 name
 ip
 isManaged
 expiresAt
 price
 status {
 vmStatus
 }
 }
 }

Payment is charged automatically via your account balance or linked payment method.

3. Query Your Servers

 query {
 servers {
 _id
 name
 ip
 provider
 isManaged
 expiresAt
 price
 createdAt
 status {
 isOnline
 vmStatus
 totalCPU
 usedCPU
 totalMemory
 usedMemory
 totalDisk
 usedDisk
 sshAvailable
 }
 }
 }

Single server:

 query {
 server(_id: "<serverID>") {
 _id
 name
 ip
 status { isOnline vmStatus }
 firewallRules { id protocol portRange sourceIP action }
 }
 }

4. Server Lifecycle Management

Power Operations

 mutation { poweroffServer(_id: "<serverID>") }
 mutation { poweronServer(_id: "<serverID>") }
 mutation { rebootServer(_id: "<serverID>") }
 mutation { reinstallServer(_id: "<serverID>", imageID: null) }

Upgrade Spec

 # Check available upgrades
 query {
 serverUpgradeOptions(serverID: "<serverID>") {
 currentPlanID
 availablePlans { name cpu memory disk price }
 }
 }

 # Upgrade
 mutation {
 upgradeServerSpec(serverID: "<serverID>", targetPlanID: "cpx32")
 }

Rename

 mutation {
 updateServerName(_id: "<serverID>", name: "my-prod-server")
 }

5. Renewal & Billing

 # Toggle auto-renewal
 mutation {
 updateServerAutoRenew(serverID: "<serverID>", autoRenew: true)
 }

 # Manually renew
 mutation {
 renewServer(serverID: "<serverID>")
 }

 # Reveal initial root password (managed servers only)
 mutation {
 revealManagedServerInitialPassword(serverID: "<serverID>")
 }

6. Firewall Rules

 # Add rule
 mutation {
 addFirewallRule(serverID: "<serverID>", rule: {
 protocol: "tcp"
 portRange: "8080"
 sourceIP: "0.0.0.0/0"
 action: ACCEPT
 })
 }

 # Delete rule
 mutation {
 deleteFirewallRule(serverID: "<serverID>", ruleID: "<ruleID>")
 }

7. Resource Alerts

 mutation {
 createServerAlert(input: {
 serverId: "<serverID>"
 metricType: CPU # CPU | MEMORY | DISK
 threshold: 90 # 0-100 (%)
 consecutiveIntervals: 3 # trigger after N consecutive breaches
 }) {
 _id
 metricType
 threshold
 }
 }

Thanks Yuanlin, much appreciated!