Delete role

edit

This API is experimental and may be changed or removed completely in a future release. Although the underlying mechanism of enforcing role-based access control is stable, the APIs for managing the roles are currently experimental.

You cannot access this endpoint via the Console in Kibana.

Authorization

edit

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

Request

edit

To delete a role, submit a DELETE request to the /api/security/role/<rolename> endpoint:

DELETE /api/security/role/my_admin_role

Response

edit

If the role is successfully deleted, the response code is 204; otherwise, the response code is 404.