API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Software

Reinstall an earlier software build (rollback)

Use this to go back to a previous build, for example one listed in history_versions of /system_information. The installer runs in the background with the given old build version; the panel and proxies restart. Returns scheduled when started or updating when an update is already running.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • rollbackSoftwareVersion
POST/v2/rollback_version

Request body application/json · required

obvstringrequired

Old build version to install.

Responses

Rollback state.

statusstring | booleanoptional
msgstringoptional

Errors returned in msg

msgMeaningWhat to do
Missing required parameter: obvThe body has no obv.Send the old build version.
Verified against XProxy v21.3.2 on Nov 17, 2026