# Update software update behavior

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



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

Endpoint: POST /update_updateconf
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `CPANEL` (any)
    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.
*  - This version has received considerable public exposure, testing, and verification.
*  - This version is feature-complete and well-tested. It contains all intended features and functionality.
*  - 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.
*  - This version only has rudimentary testing. The features are subject to further modification. This version usually lacks official public documentation.
*  - 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.
    Example: "RELEASE"

  - `RPMUP` (any)
    The frequency with which the server updates the operating system distribution's packages each time that the  script runs.

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

*  - Update the system packages daily.
*  - Update the system packages manually.
*  - If you specify , the server administrator  run the  script when they update the server's packages.
    Example: "daily"

  - `SARULESUP` (any)
    The frequency with which the server updates Apache SpamAssassin's™ rules when the  script runs.

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

*  - Update Apache SpamAssassin rules daily.
*  - Update Apache SpamAssassin rules manually.
*  - If you specify , the server administrator  run the  script when they update Apache SpamAssassin's rules.
    Example: "daily"

  - `STAGING_DIR` (string)
    The absolute directory path to the staging directory for updates.

If you do not set this parameter, the system retains the current setting.
    Example: "/usr/local/cpanel"

  - `UPDATES` (any)
    When the system will check for updates.

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

*  - Update cPanel & WHM automatically through a cron job once every 24 hours.
*  - Update cPanel & WHM manually.
*  - Do  update cPanel & WHM.
    Example: "daily"

## Response 200 fields (application/json):

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "update_updateconf"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is 0. This field may display a success message when a function succeeds.
    Example: "OK"

  - `metadata.result` (integer)
    *  - Success
*  - Failed: Check the reason field for more details.
    Enum: 0, 1

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1