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://{server-hostname}:8383/dcapi/patch/settings/declinePatch/declinePatches
PatchMgmt.UPDATECopied!
Authorization: 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://appdomain/dcapi/patch/settings/declinePatch/declinePatches \
--header 'Accept: application/declinePatches.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/declinePatches.v1+json' \
--data '{"patches":[{"reasonId":"1","id":"110001","remarks":"Vendor reported crash on reboot"}],"customGroupID":["301"]}'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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.