Page Comparison

Excerpt

Description

In a situation when where your Organization identifies that a specific role is no longer required, you will need to remove the role details from WSO2 EMM. In such situations, you can use the the REST API given below to remove a role.

URL /mdm-admin/roles?rolename={rolename}

HTTP Method DELETE

Request/Response Format application/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/roles?rolename={rolename}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
By default, <EMM_HOST> is localhost. However, 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 role you wish to delete as the value for {rolename}.

Example:

Code Block
curl -X DELETE -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/roles?rolename=engineer

Sample output

Code Block

> DELETE /mdm-admin/roles?rolename=engineer HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 13dd6b016e72a41e5905e0c28a791da1
> 
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Sun, 06 Mar 2016 13:41:14 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server

Versions Compared

Old Version 2

New Version Current

Key