kibana/docs/api/role-management/delete.asciidoc
Kaarina Tungseth fda3196611
[DOCS] Updates API requests and examples (#60695)
* [DOCS] Updates API requests and examples

* Review comments
2020-03-20 16:33:20 -05:00

27 lines
550 B
Plaintext

[[role-management-api-delete]]
=== Delete role API
++++
<titleabbrev>Delete role</titleabbrev>
++++
experimental[] Delete a {kib} role.
[[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 <kibana host>:<port>/api/security/role/my_admin_role`
[[role-management-api-delete-response-codes]]
==== Response codes
`204`::
Indicates a successful call.
`404`::
Indicates an unsuccessful call.