Declines one or more patches for the specified custom group(s) and customers, with each patch requiring a reasonId and remarks. The API does not support the Linux platform; therefore, Linux patches were automatically excluded.
https://{serverurl}/dcapi/patch/settings/declinePatch/declinePatches
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
List of patch objects to decline. Each object contains patch ID, reason ID and remarks.
List of custom group resource IDs to decline patches for. Cannot be empty.
curl --request PUT \
--url https://appdomains/dcapi/patch/settings/declinePatch/declinePatches \
--header 'Accept: application/declinePatches.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/declinePatches.v1+json' \
--data '{}'Decline a single patch for one custom group
{
"patches": [
{
"reasonId": "1",
"id": "110001",
"remarks": "Vendor reported crash on reboot"
}
],
"customGroupID": [
"301"
]
}
Decline multiple patches with different reasons for multiple custom groups
{
"patches": [
{
"reasonId": "1",
"id": "110001",
"remarks": "Vendor-reported patch issue causing BSOD"
},
{
"reasonId": "3",
"id": "110002",
"remarks": "Conflicts with in-house CRM application v4.2"
},
{
"reasonId": "5",
"id": "110003",
"remarks": "Awaiting approval from change advisory board"
}
],
"customGroupID": [
"501",
"502"
]
}
Operation result: 'success' when patches are declined successfully
Localized success message
Validation error code: INSUFFICIENT_DATA=missing required fields, INVALID_DATA=invalid format or business rule violation (e.g., All Computers mixed with other groups, non-numeric id/reasonId)
Detailed message describing the specific validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Authorization error code: UAC_UNAUTHORIZED when user lacks access to selected custom groups
Message indicating the user is not authorized to decline patches for the selected groups
Internal error code: unexpected server error during decline operation
Error message describing the internal failure
Patches declined successfully
{
"message": "Patches declined successfully",
"status": "success"
}
Patches list is empty or null
{
"errorMessage": "Patches list is empty",
"errorCode": "INSUFFICIENT_DATA"
}
A patch object is missing the required reasonId
{
"errorMessage": "reasonId is mandatory for patch id: 110001",
"errorCode": "INSUFFICIENT_DATA"
}
All Computers group selected with other custom groups
{
"errorMessage": "All Computer Groups cannot be selected with other Custom Groups",
"errorCode": "INVALID_DATA"
}
Authentication credentials missing or invalid
{
"errorMessage": "Authentication credentials are missing or invalid",
"errorCode": "UNAUTHORIZED"
}
User lacks access to the selected custom groups
{
"errorMessage": "The user is not authorized to perform this operation!",
"errorCode": "UAC_UNAUTHORIZED"
}
Unexpected server error during decline
{
"errorMessage": "An internal error occurred while processing the request",
"errorCode": "INTERNAL_ERROR"
}
![]()
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.