v1JSON over HTTPS

Reseller API

Provision and manage EggyWall VPSs using prepaid reseller balance. Servers created by the API are owned by the reseller account and remain fully accessible through both the API and the normal EggyWall VPS dashboard.

Base URL https://eggywall.org/api/reseller/v1/

Authentication

Create an API key from the reseller panel. The full key is shown once. EggyWall stores only a SHA-256 hash of the key.

Send the key with either of these headers:

Authorization: Bearer ewr_live_... # or X-API-Key: ewr_live_...

Base URL: https://eggywall.org/api/reseller/v1/

Idempotency

Provisioning, VPS and hosting renewals, and VPS resource increases charge reseller balance, so each requires a unique Idempotency-Key header. Repeating a completed request with the same key returns the original result without charging again.

Idempotency-Key: customer-order-10428

Use a new key for each new billable operation. Maximum length: 128 characters.

Plans and operating systems

GET/api/reseller/v1/plans.php

Returns currently active VPS plans, list prices, effective prices after the account discount, billing periods and supported operating systems. The response also includes the current account discount percentage.

curl https://eggywall.org/api/reseller/v1/plans.php \ -H "Authorization: Bearer YOUR_API_KEY"

Balance

GET/api/reseller/v1/balance.php
Response
{ "success": true, "currency": "USD", "balance": 125.50 }

Top-ups are created from the reseller panel and credited automatically after NOWPayments confirms the payment. Account discounts do not reduce reseller credit top-ups.

VPS endpoints

MethodEndpointPurpose
GETvps.phpList all VPSs owned by the reseller.
GETvps.php?id=123Get one VPS.
POSTvps.phpProvision and charge balance.
DELETEvps.php?id=123Delete a VPS. Deletion does not refund used service credit.
POSTresources.phpIncrease CPU, RAM and/or storage on an existing VPS and update Proxmox.
POSTrenew.phpRenew a VPS from balance, including recurring resource extras.
POSTaction.phpStart, stop, shutdown, reboot or reset.
POSTreinstall.phpReinstall the operating system.
POSTrename.phpRename the VPS in EggyWall.
GETpassword.php?id=123Reveal EggyWall's stored root/Administrator password.
POSTchange_password.phpChange the Cloud-Init password configuration (reboot and guest verification required).
POSTconsole.phpCreate a temporary noVNC websocket session.

Provision VPS

POST/api/reseller/v1/vps.php
FieldRequiredDescription
plan_idYesPlan ID returned by plans.php.
osYesOS ID returned by plans.php, e.g. ubuntu24.
external_refNoYour own customer/order reference, up to 128 characters.
nameNoOptional EggyWall display name, up to 25 characters.
Request
curl -X POST https://eggywall.org/api/reseller/v1/vps.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Idempotency-Key: order-10001" \ -H "Content-Type: application/json" \ -d '{ "plan_id": 1, "os": "ubuntu24", "external_ref": "customer-8821", "name": "Customer 8821" }'
Response
{ "success": true, "order_id": 41, "charged_usd": 15, "balance": 110.50, "vps": { "id": 73, "vmid": 121, "name": "Customer 8821", "state": "active", "power_status": "running", "os": "ubuntu24", "ipv4": "107.150.72.210", "expires_at": "2026-10-03 13:00:00" } }

If provisioning fails, the API returns an error and the reserved wallet charge is refunded.

Increase VPS resources

POST/api/reseller/v1/resources.php

Increase resources on an already-provisioned reseller VPS. Provisioning always uses the selected standard plan; resource extras are added only afterward. This endpoint only increases resources and never decreases them.

FieldRequiredDescription
idYesExisting reseller VPS ID.
add_coresNoAdditional CPU cores. $3.50 per core per 30 days.
add_ram_mbNoAdditional RAM in 1024 MB increments. $1.50 per 1024 MB per 30 days.
add_storage_gbNoAdditional storage in 10 GB increments. $1.50 per 10 GB per 30 days.

At least one increase must be greater than zero. Final limits are 20 CPU cores, 122880 MB RAM (120 GB), and 1024 GB storage (1 TB). CPU, RAM and disk are changed on the Proxmox VM. Disk storage is expansion-only.

The immediate wallet charge is prorated for the full service time remaining on the VPS, including multiple prepaid billing periods when applicable. The full recurring addon price is then included in future renewals. If the account has a global discount configured, that discount is applied at charge time.

Request
curl -X POST https://eggywall.org/api/reseller/v1/resources.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Idempotency-Key: upgrade-73-1" \ -H "Content-Type: application/json" \ -d '{ "id": 73, "add_cores": 1, "add_ram_mb": 1024, "add_storage_gb": 10 }'
Response
{ "success": true, "upgrade_id": 9, "charged_usd": 4.11, "proration_factor": 0.85, "recurring_addon_delta_usd": 6.50, "vps": { "id": 73, "resources": { "extras": {"cores":1,"ram_mb":1024,"storage_gb":10}, "total": {"cores":9,"ram_mb":13312,"storage_gb":110}, "recurring_addons_usd": 6.50 } } }
If Proxmox cannot fully verify an upgrade after the wallet has been reserved, the request is marked for reconciliation instead of automatically refunding potentially-applied resources.

Renew VPS

POST/api/reseller/v1/renew.php

The current base plan price plus all recurring resource extras is combined, the account discount is applied, and the resulting amount is deducted from reseller balance. That plan’s billing period is then added to the existing expiry. If already expired, the new period starts from the renewal time. Suspended VPSs are reactivated automatically.

curl -X POST https://eggywall.org/api/reseller/v1/renew.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Idempotency-Key: renew-73-2026-10" \ -H "Content-Type: application/json" \ -d '{"id":73}'

Power actions

POST/api/reseller/v1/action.php

Supported actions: start, shutdown, stop, reboot, reset.

curl -X POST https://eggywall.org/api/reseller/v1/action.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":73,"action":"reboot"}'

Reinstall

POST/api/reseller/v1/reinstall.php
Reinstall destroys the VPS disk contents and generates a new password.
curl -X POST https://eggywall.org/api/reseller/v1/reinstall.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":73,"os":"debian12"}'

Rename and credentials

POST/api/reseller/v1/rename.php
{"id":73,"name":"Production API"}
GET/api/reseller/v1/password.php?id=73
{ "success": true, "id": 73, "password": "..." }
POST/api/reseller/v1/change_password.php

Authenticated JSON request:

{"id":73,"new_password":"choose-a-strong-unique-password"}

Returns reboot_required: true. Updates Server Password - A Reboot is required for changes to take effect.

Treat password responses as secrets. Do not write them to application logs.

Console

POST/api/reseller/v1/console.php

Returns temporary websocket details for the same EggyWall noVNC console path used by the customer dashboard.

Request
curl -X POST https://eggywall.org/api/reseller/v1/console.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":73}'
Response
{ "success": true, "console": { "protocol": "wss", "host": "console.eggywall.cc", "port": 443, "path": "/vncws/...", "password": "...", "temporary": true } }

Delete VPS

DELETE/api/reseller/v1/vps.php?id=73
curl -X DELETE "https://eggywall.org/api/reseller/v1/vps.php?id=73" \ -H "Authorization: Bearer YOUR_API_KEY"
Deleting a VPS permanently removes it from Proxmox and EggyWall. Remaining service time is not automatically refunded.

DirectAdmin hosting plans

GET/api/reseller/v1/hosting-plans.php

Lists available web hosting plans from the EggyWall database. Each plan includes id, slug, name, description, billing_days, price_usd, effective_price_usd (after reseller discount), domains, bandwidth_gb, mailboxes, subdomains, storage_gb and ddos_label. The response also includes discount_percent. A quota of -1 means unlimited where configured; available resources must match the DirectAdmin package.

curl https://eggywall.org/api/reseller/v1/hosting-plans.php \ -H "Authorization: Bearer YOUR_API_KEY"

Purchase DirectAdmin hosting

POST/api/reseller/v1/hosting.php

Purchases a hosting account using reseller wallet balance. The API uses the reseller's EggyWall account email for DirectAdmin provisioning. The plan's current database price is discounted for the reseller. Send a unique idempotency key per purchase.

FieldRequiredDescription
actionNopurchase (default).
plan_idYesHosting plan ID from hosting-plans.php.
domainYesDomain to associate with the hosting account.
curl -X POST https://eggywall.org/api/reseller/v1/hosting.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: hosting-order-10429" \ -d '{"action":"purchase","plan_id":1,"domain":"example.com"}'

Success returns order_id, charged_usd, balance_usd, idempotent_replay and a hosting account object. A replay with the same key must use the same plan and domain.

List hosting accounts, credentials and usage

GET/api/reseller/v1/hosting.php

Without an ID, lists all hosting accounts owned by the reseller and returns their paid provisioning_orders that are still provisioning or failed (including error messages). With id, returns a single account. Account details include ID, plan, domain, DirectAdmin username and URL, nameservers, status, expiry, current plan price and billing period.

# List accounts curl https://eggywall.org/api/reseller/v1/hosting.php \ -H "Authorization: Bearer YOUR_API_KEY" # Retrieve one account, including its password and live usage curl "https://eggywall.org/api/reseller/v1/hosting.php?id=42&include_credentials=1&include_usage=1" \ -H "Authorization: Bearer YOUR_API_KEY"

include_credentials=1 adds the stored password. include_usage=1 adds a usage object with available DirectAdmin fields such as quota, bandwidth, domains, subdomains, email accounts, databases and FTP accounts. These options apply to single-account lookups, not list results.

Credentials are sensitive. Do not log API responses containing passwords or expose reseller API keys to browsers.

Renew hosting

POST/api/reseller/v1/hosting-renew.php

Renews an existing reseller-owned hosting account. The renewal uses the current hosting plan price and current reseller discount, rather than the price paid when the account was created. The billing period is added to the account's expiry. An idempotent replay retains the original transaction's price and duration.

curl -X POST https://eggywall.org/api/reseller/v1/hosting-renew.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: hosting-renew-10430" \ -d '{"id":42}'

Success returns hosting_id, charged_usd, expires_at, idempotent_replay and balance_usd.

Hosting password, provisioning retry and deletion

POST/api/reseller/v1/hosting.php

Change the password of a reseller-owned hosting account using the password action:

curl -X POST https://eggywall.org/api/reseller/v1/hosting.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"action":"password","id":42,"password":"REPLACE_WITH_STRONG_PASSWORD"}'

Retry fulfilment for an already-paid hosting order that failed provisioning. Use its hosting order ID, not the account ID. The server verifies the order is eligible; it does not permit retrying unpaid orders.

curl -X POST https://eggywall.org/api/reseller/v1/hosting.php \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"action":"retry","order_id":123}'
DELETE/api/reseller/v1/hosting.php?id=42

Permanently deletes the hosting account. Explicitly set confirm to DELETE in the request body.

curl -X DELETE "https://eggywall.org/api/reseller/v1/hosting.php?id=42" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"confirm":"DELETE"}'
Deletion is permanent and removes the DirectAdmin account and its hosted data. Back up any required files before deleting.

There is no separate reseller hosting suspension endpoint in this version; expiry-based suspension is handled by the hosting cron and administrative controls.

Errors

Errors always use a JSON object with a machine-readable code and message.

{ "success": false, "error": { "code": "insufficient_balance", "message": "Insufficient reseller balance. Required $15.00, available $7.50." } }
HTTPMeaning
400Invalid input or VPS action.
401Missing, invalid or revoked API key.
402Insufficient reseller balance.
404VPS or credential not found.
405Wrong HTTP method.
409Idempotent request is already in progress or its key cannot be reused for a new operation.
502Provisioning/renewal failed while contacting infrastructure; balance is refunded when applicable.