Performs a patch scan on selected computers or all computers managed by the Endpoint Central server.
This API endpoint is deprecating soon
post /api/1.4/patch/computers/scan
https://{serverurl}/api/1.4/patch/computers/scan Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
List of resource IDs to scan. If empty, scans all systems.
curl --request POST \
--url https://appdomains/api/1.4/patch/computers/scan \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{}'Scan selected computers by resource IDs
{
"resourceids": [
301,
302,
303
]
}
Action identifier: computers
Response payload containing scan result
Scan status object
Scan operation result message (e.g., Scan initiated successfully)
Scan operation result message (e.g., Scan initiated successfully)
Scan status object
Scan operation result message (e.g., Scan initiated successfully)
Scan operation result message (e.g., Scan initiated successfully)
API version string (e.g., 1.4)
Overall operation status: success
Error code: PATCH_SCAN_FAILED_CODE for scan failures
Error type: PATCH_SCAN_FAILED
Detailed failure reason: invalid resources, no managed computers, or scan already in progress
Scan started for selected systems
{
"message_type": "computers",
"message_response": {
"computers": {
"status": "Scan initiated successfully"
}
},
"message_version": "1.4",
"status": "success"
}
Resource IDs are invalid or not parseable
{
"error_description": "Provided Resource list is not valid",
"error_code": "PATCH_SCAN_FAILED_CODE",
"error": "PATCH_SCAN_FAILED"
}
Scan requires at least one resource ID
{
"error_description": "Scan operation requires Resource ID.",
"error_code": "PATCH_SCAN_FAILED_CODE",
"error": "PATCH_SCAN_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.