Initiates the decline action for the specified patches across all managed systems.
This API endpoint is deprecating soon
This API endpoint will be permanently removed on October 2026, please migrate to the new endpoint.
View new endpoint >post /api/1.4/patch/declinepatch
https://{serverurl}/api/1.4/patch/declinepatch
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of patch IDs to decline. Max 1000 entries.
curl --request POST \
--url https://appdomains/api/1.4/patch/declinepatch \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{"patchids":[112,113]}'Decline patches by IDs
{
"patchids": [
112,
113
]
}
Action identifier: declinepatch
Decline result payload
Decline action result
Action result message (e.g., Initiated Successfully)
API version: 1.4
Overall operation status: success
Error code: DECLINE_FAILED_CODE for decline failures
Error type: DECLINE_FAILED
Detailed failure reason: insufficient permissions, invalid patch list, or empty patches
Decline initiated successfully
{
"message_type": "declinepatch",
"message_response": {
"declinepatch": {
"status": "Initiated Successfully"
}
},
"message_version": "1.4",
"status": "success"
}
User lacks All Managed Computer role
{
"error_description": "Verify if the user is granted permissions to manage all computers!",
"error_code": "DECLINE_FAILED_CODE",
"error": "DECLINE_FAILED"
}
No patch IDs provided in request
{
"error_description": "No Patches Specified",
"error_code": "DECLINE_FAILED_CODE",
"error": "DECLINE_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.