Cloud infrastructure (Cherry Servers)

Cloud infrastructure (Cherry Servers)

Otonix provisions real servers via the Cherry Servers REST API.

It supports both VPS and bare-metal.

• Upstream API: https://api.cherryservers.com/v1

Check Cherry integration status

GET /api/cherry/status

curl -sS "https://app.otonix.tech/api/cherry/status"

{ "configured": true }

If Cherry is not configured, endpoints may return 503.

Discovery endpoints

Use these to build a provisioning UI or a planning agent.

• GET /api/cherry/plans — plans and pricing

• GET /api/cherry/regions — regions

• GET /api/cherry/images — OS images

• GET /api/cherry/teams — teams

• GET /api/cherry/projects/:teamId — projects in a team

List servers in a project

GET /api/cherry/servers/:projectId

curl -sS "https://app.otonix.tech/api/cherry/servers/12345"

Provision a server (x402 + API key)

Provisioning is a paid action if monthlyCost > 0.

You must include:

• X-API-Key for authorization

• x402 proof if a payment is required

See x402 payment protocol for proof formatting and verification rules.

Step 1: initial request (expect 402)

POST /api/cherry/servers/:projectId

curl -i -X POST "https://app.otonix.tech/api/cherry/servers/12345" \
  -H "X-API-Key: otonix_xxxxxxxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "cloud_vps_1",
    "region": "eu_nord_1",
    "hostname": "agent-alpha.otonix.tech",
    "image": "ubuntu_22_04",
    "monthlyCost": 9.95
  }'

If payment is required, you’ll get 402 with:

{
  "error": "payment_required",
  "x402Version": 2,
  "accepts": [ ... ],
  "resource": "/api/cherry/servers/12345",
  "description": "VPS provisioning: cloud_vps_1 in eu_nord_1 ($9.95/mo USDC)",
  "extra": { "orderId": "...", "amountUSDC": 9.95 }
}

Step 2: pay USDC on Base

Send USDC to the treasury address provided in the 402 requirements.

Step 3: retry with X-Payment

PROOF_JSON='{"txHash":"0x...","payer":"0x...","orderId":"..."}'
X_PAYMENT=$(printf '%s' "$PROOF_JSON" | base64 | tr -d '\n')

curl -sS -X POST "https://app.otonix.tech/api/cherry/servers/12345" \
  -H "X-API-Key: otonix_xxxxxxxxx..." \
  -H "Content-Type: application/json" \
  -H "X-Payment: $X_PAYMENT" \
  -d '{
    "plan": "cloud_vps_1",
    "region": "eu_nord_1",
    "hostname": "agent-alpha.otonix.tech",
    "image": "ubuntu_22_04",
    "monthlyCost": 9.95
  }'

Response 201 is a Cherry server object.

Treat provisioning as eventually consistent. You may need to poll GET /api/cherry/servers/:projectId.

Server actions

POST /api/cherry/servers/:serverId/actions

curl -sS -X POST "https://app.otonix.tech/api/cherry/servers/987/actions" \
  -H "X-API-Key: otonix_xxxxxxxxx..." \
  -H "Content-Type: application/json" \
  -d '{"type":"reboot"}'

Supported type values:

• reboot

• power-on

• power-off

• rebuild

• enter-rescue-mode

• exit-rescue-mode

Delete server

DELETE /api/cherry/servers/:serverId

curl -sS -X DELETE "https://app.otonix.tech/api/cherry/servers/987" \
  -H "X-API-Key: otonix_xxxxxxxxx..."

{ "deleted": true }

Local sandbox management (database)

These endpoints track server metadata inside Otonix.

• GET /api/sandboxes

• GET /api/sandboxes/:id

• POST /api/sandboxes

Sandbox object

{
  "id": "uuid",
  "name": "cherry-vm",
  "status": "running",
  "os": "Ubuntu 22.04",
  "cpu": 2,
  "memory": 4096,
  "disk": 50,
  "region": "eu_nord_1",
  "ipAddress": "185.150.0.42",
  "ports": [22, 80, 443],
  "agentId": null,
  "createdAt": "2026-02-20T12:00:00.000Z"
}