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.

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.

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

# 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

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.

# 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"

Reinstall, resize and reset password

# 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"

Backups

# 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" }'