Sign in
latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

Updates

Update software update behavior

This function modifies a server's /etc/cpupdate.conf file. This file controls how the server handles software updates and upgrades.

Important:

You must have the root level Access Control List (ACL) privilege to execute this function.

post/update_updateconf

Query parameters

'STABLE' | 'RELEASE' | 'CURRENT' | 'EDGE' | 'LTS'
OR
string cPanel version
OR
string

The cPanel & WHM installation's release tier, or a valid version number.

If you do not use this parameter, the system retains the current setting.

  • A valid cPanel & WHM version number.

  • STABLE - This version has received considerable public exposure, testing, and verification.

  • RELEASE - This version is feature-complete and well-tested. It contains all intended features and functionality.

  • CURRENT - This version is tested and verified, but it may not contain all of the proposed functionality of a release. This tier is similar to the "release candidate" tier that other publication schemes use.

  • EDGE - This version only has rudimentary testing. The features are subject to further modification. This version usually lacks official public documentation.

  • LTS - Some hosting providers do not wish to upgrade cPanel & WHM to newer major versions. This is a single cPanel & WHM version for the year-long period in which WebPros International, LLC supports it.

    If you do not set this parameter, the system retains the current setting.

New installations default to RELEASE.

'daily' | 'manual' | 'never'
OR
string

The frequency with which the server updates the operating system distribution's packages each time that the /usr/local/cpanel/scripts/upcp script runs.

If you do not set this parameter, the system retains the current setting.

  • daily - Update the system packages daily.
  • manual - Update the system packages manually.
  • never - If you specify never, the server administrator must run the /usr/local/cpanel/scripts/update-packages script when they update the server's packages.
'daily' | 'manual' | 'never'
OR
string

The frequency with which the server updates Apache SpamAssassin's™ rules when the /usr/local/cpanel/scripts/upcp script runs.

If you do not set this parameter, the system retains the current setting.

  • daily - Update Apache SpamAssassin rules daily.
  • manual - Update Apache SpamAssassin rules manually.
  • never - If you specify never, the server administrator must run the /usr/local/cpanel/scripts/update-packages script when they update Apache SpamAssassin's rules.
'hourly' | 'never'
OR
string

Whether the system applies expedited security updates for the current major version.

This setting is independent of the UPDATES setting. It drives the hourly /usr/local/cpanel/scripts/upcp --security check, which applies a security release within the current major version as soon as it is available, even when UPDATES is set to manual or never.

If you do not set this parameter, the system retains the current setting.

  • hourly - Check for and apply current-major security updates every hour. This is the default.
  • never - Do not apply expedited security updates.
STAGING_DIRstring
Example:/usr/local/cpanel

The absolute directory path to the staging directory for updates.

If you do not set this parameter, the system retains the current setting.

'daily' | 'manual' | 'never'
OR
string

When the system will check for updates.

If you do not set this parameter, the system retains the current setting.

  • daily - Update cPanel & WHM automatically through a cron job once every 24 hours.
  • manual - Update cPanel & WHM manually.
  • never - Do not update cPanel & WHM.

Response

HTTP Request was successful.

Example response

{
  "metadata": {
    "command": "update_updateconf",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}