2018-08-13 18:06:25 +02:00
|
|
|
[[role-management-api-delete]]
|
2019-09-06 18:09:57 +02:00
|
|
|
=== Delete role API
|
|
|
|
++++
|
|
|
|
<titleabbrev>Delete role</titleabbrev>
|
|
|
|
++++
|
2018-08-13 18:06:25 +02:00
|
|
|
|
2020-03-20 22:33:20 +01:00
|
|
|
experimental[] Delete a {kib} role.
|
2018-12-05 22:20:58 +01:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
[[role-management-api-delete-prereqs]]
|
2020-03-20 22:33:20 +01:00
|
|
|
==== Prerequisite
|
2018-08-13 18:06:25 +02:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
To use the delete role API, you must have the `manage_security` cluster privilege.
|
2018-08-13 18:06:25 +02:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
[[role-management-api-delete-request-body]]
|
2018-08-13 18:06:25 +02:00
|
|
|
==== Request
|
|
|
|
|
2020-03-20 22:33:20 +01:00
|
|
|
`DELETE <kibana host>:<port>/api/security/role/my_admin_role`
|
2018-08-13 18:06:25 +02:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
[[role-management-api-delete-response-codes]]
|
|
|
|
==== Response codes
|
2018-08-13 18:06:25 +02:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
`204`::
|
|
|
|
Indicates a successful call.
|
2020-03-20 22:33:20 +01:00
|
|
|
|
2019-09-06 18:09:57 +02:00
|
|
|
`404`::
|
2020-03-20 22:33:20 +01:00
|
|
|
Indicates an unsuccessful call.
|