Initiate computer removal from Scope of Management Initiates a computer removal request from the Scope of Management.
Request URL https://{server-hostname}:8383/dcapi/som/computers/actionRequest/remove
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Request Body application/json JSON Object
Hide Sub-Attributes computerIDs array Optional
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
Java
Python
Deluge
PowerShell
Copied!
curl --request DELETE \
--url https://appdomain/dcapi/som/computers/actionRequest/remove \
--header 'Accept: application/somComputerDeletedStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/computerIdsToDelete.v1+json' \
--data '{"computerIDs":["5001","5002"]}'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/dcapi/som/computers/actionRequest/remove"))
.header("Content-Type", "application/computerIdsToDelete.v1+json")
.header("Accept", "application/somComputerDeletedStatus.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("DELETE", HttpRequest.BodyPublishers.ofString("{\"computerIDs\":[\"5001\",\"5002\"]}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"computerIDs\":[\"5001\",\"5002\"]}"
headers = {
'Content-Type': "application/computerIdsToDelete.v1+json",
'Accept': "application/somComputerDeletedStatus.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("DELETE", "/dcapi/som/computers/actionRequest/remove", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/computerIdsToDelete.v1+json");
headersMap.put("Accept", "application/somComputerDeletedStatus.v1+json");
data=Map();
data_computerIDs=List();
data.put("computerIDs",data_computerIDs);
response = invokeUrl
[
url: "https://appDomain/dcapi/som/computers/actionRequest/remove"
type: DELETE
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/computerIdsToDelete.v1+json")
$headers.Add("Accept", "application/somComputerDeletedStatus.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/som/computers/actionRequest/remove' -Method DELETE -Headers $headers -ContentType 'application/computerIdsToDelete.v1+json' -Body '{"computerIDs":["5001","5002"]}'Sample Request Body Remove computers from SoM
Copied!
{
"computerIDs": [
"5001",
"5002"
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON Object
Hide Sub-Attributes status boolean
Indicates whether the computer removal request was accepted and the delayed action was successfully queued
actionRequestID string
Unique tracking identifier for this removal action request. Use this ID to poll progress via removeStatus
message string
Descriptive message providing additional context about the removal result. Present when an error occurs or additional information is needed
- HTTP code 400 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
API-specific error code identifying the validation failure
message string
Error message describing the validation failure
- HTTP code 412 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
Precondition failed error code identifying the business logic violation
message string
Error message describing the precondition failed while processing request
Possible Response Codes Sample Response: HTTP 200 {
"actionRequestID": "AR-REM-1712567890789",
"status": true
}
▼ Show full
Sample Response: HTTP 400 Missing or empty computerIDs in request
Copied!
{
"errorCode": "20006",
"message": "Resource IDs are not present in the request",
"statusCode": 400
}
▼ Show full
Sample Response: HTTP 412 Non-admin user cannot access the requested computers
Copied!
{
"errorCode": "20005",
"message": "Selected computers are not accessible",
"statusCode": 412
}
▼ Show full
Some computers are not managed by the server
Copied!
{
"errorCode": "30007",
"message": "All resources are not managed computers",
"statusCode": 412
}
▼ 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.