Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
Description

In a situation where an employee leaves the organization you will need to remove the user details from WSO2 EMM. In such situations you can use the the REST API given below to remove a user.

URL/mdm-admin/users?username={username}
HTTP MethodDELETE
Request/Response Formatapplication/json
cURL command
Code Block
curl -X DELETE -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/users?username={username} 
  • For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
  • By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
  • Provide the name of the user you wish to delete as the value for {username}.

Example:

Code Block
curl -X DELETE -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/users?username=kim
 Sample output
Code Block
 >> DELETE /mdm-admin/users?username=kim HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> 
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Sat, 05 Mar 2016 09:22:19 GMT
< Content-Type: application/json
< Content-Length: 90
< Server: WSO2 Carbon Server
< 
{"statusCode":200,"messageFromServer":"User by username: kim was successfully removed."}