DELETE /_security/role/<name>

The Roles API is generally the preferred way to manage roles, rather than using file-based role management. For more information about the native realm, see Realms and Configuring a native realm.

To use this API, you must have at least the manage_security cluster privilege.

The following example deletes a my_admin_role role:

DELETE /_security/role/my_admin_role

If the role is successfully deleted, the request returns {"found": true}. Otherwise, found is set to false.

{
  "found" : true
}