Unapprove Specified Patches Deprecating soon Initiates the patch unapproval process for the specified patches across all computers managed by the Endpoint Central server.
This API endpoint is deprecating soon
Request URL https://{server-hostname}:8383/api/1.4/patch/unapprovepatch
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
- Request Body application/json JSON Object
Hide Sub-Attributes patchids array Mandatory
Array of patch IDs to unapprove. Max 1000 entries.
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/api/1.4/patch/unapprovepatch \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{"patchids":[112,113,114]}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/api/1.4/patch/unapprovepatch"))
.header("content-type", "application/json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"patchids\":[112,113,114]}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"patchids\":[112,113,114]}"
headers = {
'content-type': "application/json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/api/1.4/patch/unapprovepatch", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/json");
headersMap.put("Accept", "application/json");
data=Map();
data_patchids=List();
data.put("patchids",data_patchids);
response = invokeUrl
[
url: "https://appDomain/api/1.4/patch/unapprovepatch"
type: POST
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("content-type", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/1.4/patch/unapprovepatch' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"patchids":[112,113,114]}'Sample Request Body {
"patchids": [
112,
113,
114
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON Object
Hide Sub-Attributes message_type string
Action identifier: unapprovepatch
status string
Overall operation status: success
- HTTP code 400 Response Body - application/json JSON Object
Hide Sub-Attributes error_code string
Error code: APPROVE_FAILED_CODE for approval failures
error string
Error type: APPROVE_FAILED
error_description string
Detailed failure reason: insufficient permissions, invalid patch list, or empty patches
Possible Response Codes Sample Response: HTTP 200 Unapproval initiated successfully
Copied!
{
"message_type": "unapprovepatch",
"message_response": {
"unapprovepatch": {
"status": "Initiated Successfully"
}
},
"message_version": "1.4",
"status": "success"
}
▼ Show full
Sample Response: HTTP 400 User lacks All Managed Computer role
Copied!
{
"error_description": "Verify if the user is granted permissions to manage all computers!",
"error_code": "APPROVE_FAILED_CODE",
"error": "APPROVE_FAILED"
}
▼ Show full
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.