* Clean up * Dashboard export API * More changes * role-management and saved-objects * Clean up * Final clean up * Clean up * Moved labels to appropriate places * Fixed rogue commits
29 lines
No EOL
767 B
Text
29 lines
No EOL
767 B
Text
[[role-management-api-delete]]
|
|
=== Delete role API
|
|
++++
|
|
<titleabbrev>Delete role</titleabbrev>
|
|
++++
|
|
|
|
Deletes a {kib} role.
|
|
|
|
experimental["This API is *experimental* and may be changed or removed completely in a future release. The underlying mechanism of enforcing role based access control is stable, but the APIs for managing the roles are currently 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.
|
|
|