Skip to content

MngGetSystemUpdates

Returns published releases newer than the version currently running on the server. Release notes are returned both per version and as one cumulative changelog suitable for display in BackOffice.

Access

Allowed session types:

  • SESSION_MANAGER
  • SESSION_ADMIN
  • SESSION_DEALER
  • SESSION_CRM_MANAGER
  • SESSION_CRM_ADMIN

The session must resolve to an enabled staff manager. All allowed managers can view update information. The response field can_update is true only when the resolved manager has super_admin = 1.

Request

No data parameters are required.

{
  "command": "MngGetSystemUpdates",
  "data": {},
  "extID": "MngGetSystemUpdates_1",
  "__token": "<manager-jwt>"
}

Response

{
  "current_version": "1.25.214",
  "latest_version": "1.25.216",
  "update_available": true,
  "can_update": false,
  "releases": [
    {
      "version": "1.25.215",
      "built_at": "2026-09-22T11:27:11.403Z",
      "released_at": "2026-09-22T12:10:00Z",
      "release_notes": "# 1.25.215\n\n- Added manual system update flow."
    },
    {
      "version": "1.25.216",
      "built_at": "2026-09-23T08:15:00.000Z",
      "released_at": "2026-09-23T09:00:00Z",
      "release_notes": "# 1.25.216\n\n- Improved updater rollback."
    }
  ],
  "combined_changelog": "# 1.25.215\n\n- Added manual system update flow.\n\n# 1.25.216\n\n- Improved updater rollback."
}
Field Type Description
current_version string Version of the running server binary
latest_version string Highest published version available; equals current_version when there is no upgrade
update_available bool true when at least one published version is newer than the running server
can_update bool Whether the current manager is a SuperAdmin and may invoke MngInstallSystemUpdate
releases array Published releases newer than current_version, ordered from oldest to newest
releases[].version string Release version accepted by the install method
releases[].built_at string UTC build timestamp from the release registry
releases[].released_at string UTC publication timestamp
releases[].release_notes string Markdown release notes for this version
combined_changelog string Release notes for every returned version joined in ascending version order

If release notes for one version cannot be loaded, the release remains in the list and its release_notes contains a diagnostic Release notes unavailable message.

No update available

{
  "current_version": "1.25.216",
  "latest_version": "1.25.216",
  "update_available": false,
  "can_update": true,
  "releases": [],
  "combined_changelog": ""
}

Errors

Handler status Error Meaning
401/403 Standard manager access error Session cannot be resolved or is not allowed by the router
503 UPDATE_REGISTRY_UNAVAILABLE Registry index could not be downloaded, exceeded the response limit or was invalid

The optional message field contains a registry diagnostic intended for administrative troubleshooting.