--- title: "Remove a user: Request" slug: "remove-a-user-request" tags: ["Reference", "NDRC 4.x", "Customer", "Network Security", "NDR 4.x"] updated: 2026-09-09T18:07:45Z published: 2026-09-09T18:07:45Z canonical: "docs.trellix.com/remove-a-user-request" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Remove a user: Request To remove an NDR appliance user, send the following request: ``` DELETE https:///config/v1/users/ ``` > [!NOTE] > Note > > To use this request, you must belong to the sudo group. Required header: ``` --user : ``` ### Options - IA_IP_address—IP address of the NDR appliance running the NDR API. - username—Administrator username. - password—Administrator password. ###### Parameters - `user` (path parameter)—The user name of the user that you want to delete. ### Example ``` DELETE https://xxx.xxx.xxx.xxx/config/v1/users/jsmith ``` Required header: ``` --user npadmin:hammerhead ``` ### Remove a user: Response ``` HTTP/1.1 [Response Code] [Response Message] Date: [Date] Content-Type: [Content Type] error:[error message if the delete operation is unsuccessful] httpStatus:[Response Code] success:[Boolean] ``` ### Response fields - Response Code—A standard HTTP response code. - Response Message—A standard HTTP response message. - Date—Standard HTML date format. - Content Type—The response format. - Boolean—Status of deletion (true or false) ### Example ``` HTTP/1.1 200 OK Date: Tue, 24 Jan 2017 21:30:31 GMT Content-Type: application/json; charset=utf-8 { "error": "", "httpStatus":200, "success": true } ``` ### cURL code sample: Remove a user The code sample was run with cURL 7.57.0. ``` curl -k --user npadmin:hammerhead https:///xxx.xxx.xxx.xxx/config/v1/users/msmith -X DELETE ``` This cURL sample includes the following options: - `-k`—This option explicitly allows cURL to perform insecure SSL connections and transfers, which allows you to test your SSL connection without installing a CA certificate. - `--user npadmin:hammerhead`—Replace `npadmin` with administrator username. Replace `hammerhead` with administrator password. - `https://xxx.xxx.xxx.xxx/config/v1/users/msmith`—The users request URL. Replace `xxx.xxx.xxx.xxx` with the IP address of your NDR appliance. Replace `msmith` with the user name of the user you wish to remove. - `-X DELETE`—This option specifies using the DELETE method. ### Results This example removes the specified NDR appliance user. The output is in JSON format.