latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

Databases
Manage MySQL Server

Start background MySQL upgrade

This function upgrades MySQL® or MariaDB® in the background. This will reinstall MySQL® or MariaDB® if the version given is the installed version.

Important:

When you disable the MySQL/MariaDB server role and remote MySQL® is not already configured, the system disables this function.

get/start_background_mysql_upgrade

Query parameters

versionnumber required
Example:5.7

The desired MySQL® or MariaDB® version. Must contain one decimal.

Response

HTTP Request was successful.

Example response

{
  "data": {
    "upgrade_id": "mysql_upgrade.20200202-172923"
  },
  "metadata": {
    "command": "start_background_mysql_upgrade",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}