# Enzonic Cloud API

> An API-first hosting control plane for game and application servers. Deploy, manage, and monitor servers via REST API or SDK across multiple regions. Billed hourly from a prepaid credit balance.

Enzonic Cloud API is a multi-tenant developer platform that sits in front of game-server panels. Users authenticate with API keys, deploy servers with a single REST call, and pay hourly from a credit balance. The platform handles placement (region/stock engine), metered billing, file management, power control, and console streaming.

**Languages:** English (en, at the root) and Spanish (es, under the /es path prefix — e.g. https://cloud.api.panel.enzonic.com/es, https://cloud.api.panel.enzonic.com/es/eggs)
**Regions:** USA 🇺🇸, Spain/EU 🇪🇸

## Contact
- **Email:** admin@enzonic.com
- **Discord (support):** https://discord.enzonic.com
- **Company:** Enzonic
- **Free hosting (no-code, sister product):** https://enzonic.com

## Key Capabilities

- Deploy game/app servers in US and EU regions with a single REST call
- Manage files, power signals, and console via the same API
- Metered hourly billing from a prepaid credit balance ($10 trial credit on signup)
- Advanced budgets with monthly caps, alerts, and auto-suspend
- Scoped API keys with IP restrictions and expiry
- Stripe checkout for credit top-ups with invoices
- Audit logs for all actions
- JavaScript/TypeScript SDK: `@enzonic/cloud-api`
- OpenAPI spec and Swagger UI at https://cloud.api.enzonic.com/docs

## REST API

Base URL: https://cloud.api.enzonic.com
Authentication: `Authorization: Bearer <api_key>`
Rate limit: 240 requests/minute

### Core Endpoints

GET  /v1/account               — Account info and credit balance
GET  /v1/regions               — Available regions and capacity
GET  /v1/eggs                  — Deployable server templates
GET  /v1/servers               — List your servers
POST /v1/servers               — Deploy a new server
GET  /v1/servers/:id           — Get server details
PATCH /v1/servers/:id          — Resize server resources
DELETE /v1/servers/:id         — Delete a server
POST /v1/servers/:id/power     — Power signal (start/stop/restart/kill)
GET  /v1/servers/:id/resources — Live CPU/RAM/disk usage
POST /v1/servers/:id/command   — Send a console command
GET  /v1/servers/:id/console   — WebSocket credentials for console
GET  /v1/servers/:id/files     — List files
POST /v1/servers/:id/files/write — Write a file
GET  /v1/billing/config        — Billing config (Stripe, currency, bonus)
POST /v1/billing/checkout      — Start Stripe checkout for top-up
GET  /v1/invoices              — List invoices
GET  /v1/account/budget        — Budget status
PUT  /v1/account/budget        — Update monthly budget cap
GET  /v1/account/logs          — Activity log

### Deploy Example

```json
POST /v1/servers
{
  "name": "my-minecraft-server",
  "eggId": 3,
  "region": "USA",
  "ramMb": 2048,
  "cpuPercent": 200,
  "diskMb": 10240
}
```

## JavaScript SDK

```js
import { CloudClient } from "@enzonic/cloud-api";
const cloud = new CloudClient({ apiKey: process.env.CLOUD_API_KEY });
const eggs = await cloud.eggs();
const egg = eggs.find((e) => e.name.includes("Paper"));
const server = await cloud.servers.create({ name: "smp", eggId: egg.id, region: "USA", ramMb: 2048, cpuPercent: 200, diskMb: 10240 });
await cloud.servers.power(server.id, "start");
```

## Per-app deploy guides (custom landing pages)

Browse all: https://cloud.api.panel.enzonic.com/eggs

### Minecraft
- [Paper](https://cloud.api.panel.enzonic.com/eggs/minecraft): deploy Paper via REST/SDK
- [Forge Minecraft](https://cloud.api.panel.enzonic.com/eggs/minecraft-forge): deploy Forge Minecraft via REST/SDK
- [NeoForge](https://cloud.api.panel.enzonic.com/eggs/minecraft-neoforge): deploy NeoForge via REST/SDK
- [Vanilla Minecraft](https://cloud.api.panel.enzonic.com/eggs/minecraft-vanilla): deploy Vanilla Minecraft via REST/SDK
- [Vanilla Bedrock](https://cloud.api.panel.enzonic.com/eggs/minecraft-bedrock): deploy Vanilla Bedrock via REST/SDK
- [Velocity](https://cloud.api.panel.enzonic.com/eggs/minecraft-velocity): deploy Velocity via REST/SDK

### Game Servers
- [Rust](https://cloud.api.panel.enzonic.com/eggs/rust): deploy Rust via REST/SDK
- [Palworld](https://cloud.api.panel.enzonic.com/eggs/palworld): deploy Palworld via REST/SDK
- [Valheim](https://cloud.api.panel.enzonic.com/eggs/valheim): deploy Valheim via REST/SDK
- [ARK: Survival Ascended](https://cloud.api.panel.enzonic.com/eggs/ark-survival-ascended): deploy ARK: Survival Ascended via REST/SDK
- [Project Zomboid](https://cloud.api.panel.enzonic.com/eggs/project-zomboid): deploy Project Zomboid via REST/SDK
- [Terraria Vanilla](https://cloud.api.panel.enzonic.com/eggs/terraria): deploy Terraria Vanilla via REST/SDK
- [Satisfactory](https://cloud.api.panel.enzonic.com/eggs/satisfactory): deploy Satisfactory via REST/SDK
- [Factorio](https://cloud.api.panel.enzonic.com/eggs/factorio): deploy Factorio via REST/SDK
- [Counter-Strike 2](https://cloud.api.panel.enzonic.com/eggs/counter-strike-2): deploy Counter-Strike 2 via REST/SDK
- [Garrys Mod](https://cloud.api.panel.enzonic.com/eggs/garrys-mod): deploy Garrys Mod via REST/SDK
- [7 Days To Die](https://cloud.api.panel.enzonic.com/eggs/7-days-to-die): deploy 7 Days To Die via REST/SDK

### Apps & Runtimes
- [node.js generic](https://cloud.api.panel.enzonic.com/eggs/nodejs): deploy node.js generic via REST/SDK
- [python generic](https://cloud.api.panel.enzonic.com/eggs/python): deploy python generic via REST/SDK
- [golang generic](https://cloud.api.panel.enzonic.com/eggs/golang): deploy golang generic via REST/SDK

### Databases
- [Postgres 16](https://cloud.api.panel.enzonic.com/eggs/postgres): deploy Postgres 16 via REST/SDK
- [Redis-7](https://cloud.api.panel.enzonic.com/eggs/redis): deploy Redis-7 via REST/SDK
- [MongoDB](https://cloud.api.panel.enzonic.com/eggs/mongodb): deploy MongoDB via REST/SDK

## Documentation

- Quickstart: https://cloud.api.panel.enzonic.com/docs/quickstart
- Authentication: https://cloud.api.panel.enzonic.com/docs/authentication
- Deploying servers: https://cloud.api.panel.enzonic.com/docs/servers
- Credits & billing: https://cloud.api.panel.enzonic.com/docs/billing
- Budgets: https://cloud.api.panel.enzonic.com/docs/budgets
- API key restrictions: https://cloud.api.panel.enzonic.com/docs/key-restrictions
- REST reference: https://cloud.api.panel.enzonic.com/docs/rest
- SDK reference: https://cloud.api.panel.enzonic.com/docs/sdk
- Errors: https://cloud.api.panel.enzonic.com/docs/errors
- Self-hosting: https://cloud.api.panel.enzonic.com/docs/self-hosting

## Pricing

Servers are metered hourly. Monthly base rates (admin-configurable):
- RAM: $0.70/GB/month
- CPU: $0.10/100%/month
- Disk: $0.05/GB/month

New accounts start with $10 in trial credits — no card required.

## Support

Discord: https://discord.enzonic.com
Email: admin@enzonic.com
Website: https://enzonic.com