Reseller & API

Manage a service (power, console, usage, lifecycle, backups)

Control a provisioned service: power signals, console access, usage stats, suspend/unsuspend, reinstall, resize, reset-password, backups and termination.

managepowerconsolesuspendresizebackupsterminate

Once a service exists, you drive its whole lifecycle through /services/{id}/... endpoints. The same actions map to the panel tabs (Console, Backups, Settings, etc.) your customers would otherwise use manually.

Power signals

Send start / stop / restart / kill via POST /services/{id}/power.

bash

curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/power \
  -H "Authorization: Bearer $VICTUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "signal": "restart" }'   # start | stop | restart | kill

Console and commands

bash

# Get a short-lived console/websocket token for a live terminal
curl https://control.victuscloud.com/api/reseller/v1/services/$SID/console \
  -H "Authorization: Bearer $VICTUS_KEY"

# Send a single command to the running service
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/command \
  -H "Authorization: Bearer $VICTUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "command": "say Restarting in 30s" }'

Live usage stats

bash

curl https://control.victuscloud.com/api/reseller/v1/services/$SID/usage \
  -H "Authorization: Bearer $VICTUS_KEY"
# returns CPU %, memory, disk and network for the service

Suspend, unsuspend and terminate

Suspend a service when a customer stops paying you; unsuspend when they return. Terminate deletes it and stops all future charges.

bash

# Suspend (stops + blocks access, keeps data)
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/suspend \
  -H "Authorization: Bearer $VICTUS_KEY"

# Unsuspend
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/unsuspend \
  -H "Authorization: Bearer $VICTUS_KEY"

# Terminate (irreversible)
curl -X DELETE https://control.victuscloud.com/api/reseller/v1/services/$SID \
  -H "Authorization: Bearer $VICTUS_KEY"

Termination destroys data

DELETE is irreversible — the service, its files and any VPS disk are removed. Take a backup or snapshot first if you might need the data, and confirm on your side before calling it.

Reinstall, resize and reset password

bash

# Reinstall / rebuild from a template or egg (wipes the service)
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/reinstall \
  -H "Authorization: Bearer $VICTUS_KEY"

# Resize to a different plan (upgrade / downgrade); credit cost adjusts
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/resize \
  -H "Authorization: Bearer $VICTUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "vps-4c-8g" }'

# Reset the root / service password (returns or emails the new one)
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/reset-password \
  -H "Authorization: Bearer $VICTUS_KEY"

Reinstall wipes the service

Reinstall rebuilds from scratch and erases current data. Warn the customer and back up first. Resize may require a short reboot; a VPS downsize can be blocked if current disk usage exceeds the smaller plan.

Backups

bash

# List backups
curl https://control.victuscloud.com/api/reseller/v1/services/$SID/backups \
  -H "Authorization: Bearer $VICTUS_KEY"

# Create a backup / snapshot now
curl -X POST https://control.victuscloud.com/api/reseller/v1/services/$SID/backups \
  -H "Authorization: Bearer $VICTUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "pre-reinstall" }'

Actions are queued

Lifecycle actions (reinstall, resize, backup) return 202 and run in the background. Watch the service status or the matching webhook event instead of assuming instant completion.

Related in Reseller & API

Reseller API overview (sell VPS, game, bot and app hosting under your brand)What the Victus Reseller API is, what you can sell with it, and how the prepaid credit model works so you can build your own storefront on top of Victus infrastructure.Get an API key and understand the prepaid credit modelMint a reseller API key (rslr_...) from the Reseller API page in the Victus panel, store it safely, and top up the prepaid credit balance the API spends.Authentication and base URLThe Reseller API base URL, how to send your rslr_ bearer token, required headers, and a quick authenticated request to confirm your key works.Response format, errors, rate limits and scopesThe standard success {data} and error {errors:[{code,status,detail}]} envelopes, common HTTP status codes, the 240 req/min rate limit, and how key scopes restrict access.List the catalog, plans and regionsRead the available product categories, plans and pricing with GET /catalog, drill into a specific plan code, and list deployment regions with GET /regions.Provision a service (VPS, game, bot and app examples)Create services with POST /services for every category — full curl examples for a VPS, a Minecraft game server, a Discord bot and an app, plus how to poll until it is ready.List services, get a single service, and check your balanceUse GET /services to list everything you have provisioned, GET /services/{id} for one service, GET /account for your credit balance, and GET /account/transactions for the ledger.Webhooks (events and X-Victus-Signature HMAC verification)Register a webhook endpoint with PUT /webhooks, receive service and billing events, and verify every delivery with the X-Victus-Signature HMAC header.