latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

ModSecurity
Rule Vendor Settings

Update ModSecurity vendor ruleset

This function updates a vendor with the current version of the rule set.

Important:

When you disable the Web Server role, the system disables this function.

get/modsec_update_vendor

Query parameters

urlstring url required
Example:http://example.com/update/meta_MyVendor.yaml

The vendor metadata file's URL.

Response

HTTP Request was successful.

Example response

{
  "data": {
    "diagnostics": {
      "added_configs": [
        "modsec_vendor_configs/MyVendor/three.conf"
      ],
      "deleted_configs": [
        "modsec_vendor_configs/MyVendor/one.conf"
      ],
      "new_configs": [
        {
          "config": "modsec_vendor_configs/MyVendor/two.conf",
          "vendor_id": "MyVendor"
        }
      ],
      "prev_configs": [
        {
          "config": "modsec_vendor_configs/MyVendor/two.conf"
        }
      ]
    },
    "vendor": {
      "archive_url": "http://example.com/update/MyVendor.zip",
      "description": "This is an example of a custom vendor set (updated).",
      "dist_md5": "ecafce1bf148532250a8d4743a8374d1",
      "enabled": 1,
      "inst_dist": "MyVendor-2",
      "installed": 1,
      "installed_from": "http://example.com/update/meta_MyVendor.yaml",
      "name": "My Vendor",
      "path": "/usr/local/apache/conf/modsec_vendor_configs/MyVendor",
      "report_url": "http://example.com/report/",
      "vendor_id": "MyVendor",
      "vendor_url": "http://example.com/"
    }
  },
  "metadata": {
    "command": "modsec_update_vendor",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}