# Otwa Cloud

> Enterprise-grade cloud infrastructure — deploy and manage VPS/cloud servers, domains, DNS, BGP sessions, and payments programmatically via REST API.

Otwa Cloud is a cloud hosting platform. Customers can deploy Linux and Windows servers, boot custom ISOs (MikroTik / VyOS / FreeBSD), announce their own IP space via BGP, register domains, manage authoritative DNS and reverse DNS, pay with crypto or card, and automate everything via a scope-gated REST API.

## API

- Base URL: https://otwa.cloud/api/v1
- Authentication: Bearer token (scoped API key minted from the dashboard)
- Format: JSON
- Current version: v1.9 (2026-04-24)

## Machine-Readable Resources

- OpenAPI 3.0.3 spec:       https://otwa.cloud/openapi.json
- Plain-text Markdown docs: https://otwa.cloud/docs.md
- Human docs page:          https://otwa.cloud/docs

## Scopes

- account:read     — Account info, balance, reseller state, catalog (products, regions, OS templates)
- servers:read     — List/view servers, credentials, live stats, add-on catalog
- servers:write    — Deploy, rename, power, reset password, purchase add-ons, issue SSO
- servers:destroy  — Terminate OR reinstall (both destroy disk data; opt-in; NOT in the default scope set)
- billing:read     — Balance and invoice history

## Endpoints

Catalog (account:read)
- GET  /api/v1/products        — Available server plans (wholesale prices for reseller keys)
- GET  /api/v1/regions         — Deployment regions with display-ready names
- GET  /api/v1/os-templates    — All OS families + versions; id is the value for POST /servers `os`

Account (account:read)
- GET  /api/v1/account         — Authenticated account details + balance
- GET  /api/v1/reseller        — Reseller state (null for non-reseller accounts)
- POST /api/v1/sso             — 5-minute single-use dashboard login URL

Servers
- GET    /api/v1/servers                          — List servers (servers:read)
- POST   /api/v1/servers                          — Deploy; honours Idempotency-Key header (servers:write)
- GET    /api/v1/servers/:id                      — Full server detail (servers:read)
- GET    /api/v1/servers/:id/credentials          — Admin login (SSH root / RDP Administrator) (servers:read)
- GET    /api/v1/servers/:id/stats                — Live CPU / memory / disk / network (servers:read)
- PATCH  /api/v1/servers/:id/label                — Rename (servers:write)
- POST   /api/v1/servers/:id/power/start|stop|reboot — Power action (servers:write)
- POST   /api/v1/servers/:id/reinstall            — Wipe + rebuild from a new OS template; preserves id/label/region/IP/addons; body {os, osTemplate}; supports Idempotency-Key (servers:destroy)
- POST   /api/v1/servers/:id/password-reset       — Rotate admin password live via guest agent (servers:write)
- POST   /api/v1/servers/:id/sso                  — 5-minute SSO URL to server detail page (servers:read)
- GET    /api/v1/servers/:id/addons               — Available add-ons + prorated pricing (servers:read)
- POST   /api/v1/servers/:id/addons               — Attach add-on; prorated charge, monthly price bumped (servers:write)
- DELETE /api/v1/servers/:id                      — Permanent termination (servers:destroy, irreversible)

## Contact

- Support:            support@otwa.cloud
- Dashboard:          https://otwa.cloud/dashboard
- API key generation: https://otwa.cloud/dashboard/api
- Status page:        https://otwa.cloud/status