Remove a computer Deprecating soon

Removes the specified computers from Endpoint Central. The computers will no longer be managed by 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/removecomputer

Copy full URL

Request URL

https://{server-hostname}:8383/api/1.4/som/computers/removecomputer

Scope

SOM.UPDATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

- 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://appdomain/api/1.4/som/computers/removecomputer \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/json' \
  --data '{"resourceids":[301]}'

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

import http.client

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

payload = "{\"resourceids\":[301]}"

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

conn.request("POST", "/api/1.4/som/computers/removecomputer", 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();
    data_resourceids=List();
    data_resourceids.add("1");
    data.put("resourceids",data_resourceids);

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

    info response;

$headers=@{}
$headers.Add("content-type", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/1.4/som/computers/removecomputer' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"resourceids":[301]}'

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": "Computer Removal 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.