API Documentation – serverforge.shop

ServerForge provides a full REST API for managing your VPS instances programmatically. Authenticate with your API key using the Authorization header.

curl -X GET https://api.serverforge.shop/v1/servers \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

Generate your API key from the dashboard under Settings → API Keys. Include it in the Authorization header as a Bearer token on every request.

Endpoints

GET/v1/servers

List all VPS instances associated with your account, including status, IP, and configuration.

POST/v1/servers

Create a new VPS instance. Specify the plan, operating system, and datacenter location.

GET/v1/servers/{id}

Retrieve detailed information about a specific VPS instance, including metrics and billing.

POST/v1/servers/{id}/reboot

Reboot a running VPS instance. Returns immediately; the server reboots asynchronously.

DELETE/v1/servers/{id}

Terminate a VPS instance. This action is irreversible and all data will be deleted.

GET/v1/servers/{id}/metrics

Retrieve real-time CPU, memory, disk, and network metrics for a VPS instance.

Example Response

{
  "id": "srv_8f3a2b",
  "status": "running",
  "plan": "forge-s7",
  "ip": "203.0.113.42",
  "ipv6": "2001:db8::8f3a",
  "location": "sg-singapore",
  "created_at": "2025-01-15T08:30:00Z"
}

Rate Limits

The API allows up to 600 requests per minute per API key. Exceeding this limit returns a 429 Too Many Requests response. Include retry logic with exponential backoff in your integrations.