1e3f14395c
* [DOCS] API intro * Logstash configuration management * Reformatting * Comments from Josh * Commets from Gail * Fixed broken things
29 lines
667 B
Plaintext
29 lines
667 B
Plaintext
[[role-management-api-delete]]
|
|
=== Delete role API
|
|
++++
|
|
<titleabbrev>Delete role</titleabbrev>
|
|
++++
|
|
|
|
Delete a {kib} role.
|
|
|
|
experimental["The underlying mechanism of enforcing role-based access control is stable, but the APIs for managing the roles are experimental."]
|
|
|
|
[[role-management-api-delete-prereqs]]
|
|
==== Prerequisite
|
|
|
|
To use the delete role API, you must have the `manage_security` cluster privilege.
|
|
|
|
[[role-management-api-delete-request-body]]
|
|
==== Request
|
|
|
|
`DELETE /api/security/role/my_admin_role`
|
|
|
|
[[role-management-api-delete-response-codes]]
|
|
==== Response codes
|
|
|
|
`204`::
|
|
Indicates a successful call.
|
|
|
|
`404`::
|
|
Indicates an unsuccessful call.
|
|
|