Uninstall agent on a computer Deprecating soon

Initiates the uninstallation process for the Endpoint Central agent on managed computer in Endpoint Central

This API endpoint is deprecating soon

This API endpoint will be permanently removed on January 2027, please migrate to the new endpoint.

View new endpoint >

Endpoints

post /api/1.4/som/computers/uninstallagent

Copy full URL

Request URL

https://{serverurl}/api/1.4/som/computers/uninstallagent

Scope

DesktopCentralCloud.SOM.UPDATECopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Query Parameters

resource_idstringOptional

Deprecated param not applicable

- Request Body

application/json

JSON Object

Hide Sub-Attributes

resourceidsarrayOptional

Specify the resource IDs of the computers. You can obtain these IDs from the response of this Computers API, under the resource_id_string field.

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

curl --request POST \
  --url https://appdomains/api/1.4/som/computers/uninstallagent \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{}'

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://appdomains/api/1.4/som/computers/uninstallagent"))
        .header("content-type", "application/json")
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("POST", HttpRequest.BodyPublishers.ofString("{}"))
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("appdomains")

payload = "{}"

headers = {
    'content-type': "application/json",
    'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("POST", "/api/1.4/som/computers/uninstallagent", 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();

    response = invokeUrl
    [
        url: "https://appDomains/api/1.4/som/computers/uninstallagent"
        type: POST
        headers: headersMap
        body: data
        connection: connection_name
    ]

    info response;

$headers=@{}
$headers.Add("content-type", "application/json")
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomains/api/1.4/som/computers/uninstallagent' -Method POST -Headers $headers -ContentType 'application/json' -Body '{}'

Sample Request Body

Copied!

  {
    "resourceids": [
      301
    ]
  }

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Hide Sub-Attributes

message_typestring

Name of the module

message_responseJSON Object

Response message containing computer's operation status

Show Sub-Attributes

computersJSON Object

Show Sub-Attributes

Statusstring

Indicates the status of the task initiated

message_versionstring

Version of the Api

statusstring

Status of the request

Possible Response Codes

200HTTP code

Request processed successfully

Sample Response: HTTP 200

Copied!

  {
    "message_type": "computers",
    "message_response": {
      "computers": {
        "Status": "UnInstallation initiated successfully"
      }
    },
    "message_version": "1.4",
    "status": "success"
  }

▼ Show full

Duration: 1 minute | Threshold: 120 | 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.