API Reference

The Simplewala API is a REST API that lets you manage servers, applications, databases, and more programmatically. The base URL is:

https://simplewala.cloud/api/v1

The full interactive OpenAPI specification is available at:

https://simplewala.cloud/openapi.json

Authentication

All API requests require an API key passed as a Bearer token in the Authorization header:

curl https://simplewala.cloud/api/v1/servers \
  -H "Authorization: Bearer sw_live_xxxxxxxxxxxxxxxx"

Generate API keys from Portal → Account → API Keys.

Response format

All responses are JSON. Successful responses include a data field. Errors include a message field and an appropriate HTTP status code.

// Success
{"data": { "id": "srv_abc123", "name": "my-server", "status": "active" }}

// Error
{"message": "Server not found", "code": "NOT_FOUND"}

Rate limits

API requests are rate-limited to 120 requests per minute per API key. The response includes rate-limit headers:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1716000060

Endpoints

Servers

• GET /servers — list all servers
• GET /servers/:slug — get a server
• POST /servers/:slug/reboot — reboot a server
• POST /servers/:slug/power-off — power off a server

Applications

• GET /servers/:slug/apps — list installed apps
• POST /servers/:slug/apps/:app/restart — restart an app

Databases

• GET /servers/:slug/databases — list databases
• POST /servers/:slug/databases — create a database
• DELETE /servers/:slug/databases/:id — delete a database

Backups

• GET /servers/:slug/backups — list backups
• POST /servers/:slug/backups — trigger a backup
• POST /servers/:slug/backups/:id/restore — restore a backup

See Servers API and Applications API for full request/response schemas.