Delete a user Deletes the specified user account and returns the deletion status.
Request URL https://{server-hostname}:8383/emsapi/users/{userId}
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Path Parameters userId string Mandatory
Unique user identifier. To get user id click here. Get User Id
- Request Body application/userDeletion.v1+json Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request DELETE \
--url https://appdomain/emsapi/users/{userId} \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/userDeletion.v1+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://appdomain/emsapi/users/{userId}"))
.header("content-type", "application/userDeletion.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("DELETE", 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("appdomain")
payload = "{}"
headers = {
'content-type': "application/userDeletion.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("DELETE", "/emsapi/users/{userId}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/userDeletion.v1+json");
headersMap.put("Accept", "application/json");
data=List();
response = invokeUrl
[
url: "https://appDomain/emsapi/users/{userId}"
type: DELETE
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("content-type", "application/userDeletion.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/emsapi/users/{userId}' -Method DELETE -Headers $headers -ContentType 'application/userDeletion.v1+json' -Body '{}'▼ Show full
Sample Request Body Delete a user with an empty request body object.
Copied!
{}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON object
Hide Sub-Attributes userCreatedByDC boolean
Indicates whether the user account was created by Endpoint Central.
domainName string
Domain name of the deleted user.
userName string
Username of the deleted user.
Possible Response Codes Sample Response: HTTP 200 User deletion succeeds and returns deleted user identity.
Copied!
{
"userCreatedByDC": true,
"domainName": "local",
"userName": "alex.morgan"
}
▼ 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.