Initiates an agent uninstallation request on one or more.
https://{serverurl}/dcapi/som/computers/actionRequest/unInstallAgent
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of computer resource IDs to perform the uninstallation on (maximum 1000 per request)
Optional administrator-provided reason or feedback explaining why this action is being performed (max 500 characters)
When SDP is integrated whether to keep the asset data in SDP
When set to true, the MDM (Mobile Device Management) profile is also removed from the computer along with the agent
curl --request POST \
--url https://appdomains/dcapi/som/computers/actionRequest/unInstallAgent \
--header 'Accept: application/somComputerAgentUninstallStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/somComputerIDsToUninstallAgent.v1+json' \
--data '{"computerIDs":["3001","3002","3003"]}'Uninstall agent from multiple computers
{
"removeMDMProfile": true,
"computerIDs": [
"3001",
"3002",
"3003"
],
"keepAssetPost": false,
"actionFeedback": "Decommissioning old workstations"
}
Array of resource IDs originally submitted in the agent uninstallation request
Array of resource IDs for computers where the agent is currently installed and available for uninstallation
Indicates whether the agent uninstallation request was accepted and the delayed action was successfully queued
Unique tracking identifier for this uninstallation action request.
HTTP status code (400)
API-specific error code identifying the validation failure
Error message describing the validation failure
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
Uninstall request initiated
{
"agentAvailableComputers": [
3001,
3002
],
"requestedComputers": [
3001,
3002,
3003
],
"actionRequestID": "AR-UNINST-1712567890456",
"status": true
}
Missing or empty computerIDs in request
{
"errorCode": "20006",
"message": "Resource IDs are not present in the request",
"statusCode": 400
}
Non-admin user cannot access the requested computers
{
"errorCode": "20005",
"message": "Selected computers are not accessible",
"statusCode": 412
}
Some computers are not managed by the server
{
"errorCode": "30007",
"message": "All resources are not managed computers",
"statusCode": 412
}
![]()
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.