Initiates a computer removal request from the Scope of Management.
delete /dcapi/som/computers/actionRequest/remove
https://{serverurl}/dcapi/som/computers/actionRequest/remove
DesktopCentralCloud.SOM.DELETECopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of computer resource IDs to perform the operation, get computer IDs from the response of the Computers API, under the resource_id field.
curl --request DELETE \
--url https://appdomain/dcapi/som/computers/actionRequest/remove \
--header 'Accept: application/somComputerDeletedStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/computerIdsToDelete.v1+json' \
--data '{}'Remove computers from SoM
{
"computerIDs": [
"5001",
"5002"
]
}
Indicates whether the computer removal request was accepted and the delayed action was successfully queued
Unique tracking identifier for this removal action request. Use this ID to poll progress via removeStatus
Descriptive message providing additional context about the removal result. Present when an error occurs or additional information is needed
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
Removal initiated
{
"actionRequestID": "AR-REM-1712567890789",
"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.