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.

Note: 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.