Uninstalls specified patches from all applicable systems.
post /api/1.4/patch/uninstallpatch
https://{serverurl}/api/1.4/patch/uninstallpatch
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of patch IDs to uninstall. Mandatory for uninstall.
Array of target resource IDs. If omitted, uninstalls from all applicable systems.
Name for the uninstall patch configuration
Description for the uninstall patch configuration
Deployment action: Deploy, DeployImmediately, or Draft
Deployment policy template ID. Fetch from Get Deployment Policies
curl --request POST \
--url https://appdomains/api/1.4/patch/uninstallpatch \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{"PatchIDs":[27170],"ConfigName":"API uninstall patch test1","actionToPerform":"Deploy","DeploymentPolicyTemplateID":1}'Uninstall patches from all applicable systems
{
"PatchIDs": [
27170
],
"ConfigName": "API uninstall patch test1",
"actionToPerform": "Deploy",
"ConfigDescription": "API test",
"DeploymentPolicyTemplateID": 1
}
Uninstall patches from specific target systems
{
"PatchIDs": [
27170
],
"ConfigName": "API uninstall patch test1",
"ResourceIDs": [
601,
602
],
"actionToPerform": "Deploy",
"ConfigDescription": "API test",
"DeploymentPolicyTemplateID": 1
}
Action identifier: uninstallpatch
Uninstall result payload
Empty object on success — uninstall initiated asynchronously
API version: 1.4
Overall operation status: success
Error code: PATCH_INSTALL_FAILED_CODE for install failures, PATCH_UNINSTALL_FAILED_CODE for uninstall failures
Error type: PATCH_INSTALL_FAILED or PATCH_UNINSTALL_FAILED
Detailed failure reason: invalid targets, mixed platforms, patches already installed, no missing patches, insufficient permissions, or invalid configuration
Uninstall deployment initiated
{
"message_type": "uninstallpatch",
"message_response": {
"uninstallpatch": {}
},
"message_version": "1.4",
"status": "success"
}
No patch IDs specified for uninstall
{
"error_description": "No Patches Specified",
"error_code": "PATCH_UNINSTALL_FAILED_CODE",
"error": "PATCH_UNINSTALL_FAILED"
}
Patches span multiple platform types
{
"error_description": "Specified Patches are not of the same platform/type",
"error_code": "PATCH_INSTALL_FAILED_CODE",
"error": "PATCH_INSTALL_FAILED"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.