Permanently deletes the role identified by roleId. The default Administrator role cannot be deleted.
https://{serverurl}/emsapi/roles/{roleId}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the expected response format. Set to application/deleteRole.v1+json to receive the role deletion response in JSON format.
Unique role identifier. To get role id click here. Get Role Id
curl --request DELETE \
--url https://appdomains/emsapi/roles/{roleId} \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'accept: application/deleteRole.v1+json'Success message confirming role deletion.
Success code for the role deletion operation.
Role deletion success response.
{
"message": "Role Security Auditor has been deleted successfully.",
"successCode": "40021"
}
![]()
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.