[OpenAPI][DOCS] Add descriptions, examples, responses for role APIs (e…

…lastic#195527) Co-authored-by: Elena Shostak <[email protected]> (cherry picked from commit 02fab72)
lcawl · Oct 28, 2024 · 0cb14b5 · 0cb14b5
1 parent 04cc48a
commit 0cb14b5
Show file tree

Hide file tree

Showing 32 changed files with 762 additions and 7,550 deletions.
diff --git a/docs/api/role-management.asciidoc b/docs/api/role-management.asciidoc
@@ -1,24 +1,8 @@
-[role="xpack"]
 [[role-management-api]]
 == {kib} role management APIs
 
 Manage the roles that grant <<kibana-privileges, {kib} privileges>>.
 
 WARNING: Do not use the {ref}/security-api.html#security-role-apis[{es} role management APIs] to manage {kib} roles.
 
-The following {kib} role management APIs are available:
-
-* <<role-management-api-put, Create or update role API>> to create a new {kib} role, or update the attributes of an existing role
-* <<role-management-api-put-bulk, Bulk create or update roles API>> to create a new {kib} roles, or update the attributes of existing roles
-
-* <<role-management-api-get, Get all {kib} roles API>> to retrieve all {kib} roles
-
-* <<role-management-specific-api-get, Get specific role API>> to retrieve a specific role
-
-* <<role-management-api-delete, Delete role API>> to delete a {kib} role
-
-include::role-management/put.asciidoc[]
-include::role-management/get.asciidoc[]
-include::role-management/get-all.asciidoc[]
-include::role-management/delete.asciidoc[]
-include::role-management/put-bulk.asciidoc[]
+For the latest API details, refer to {api-kibana}/group/endpoint-roles[role APIs].
diff --git a/docs/api/role-management/delete.asciidoc b/docs/api/role-management/delete.asciidoc
diff --git a/docs/api/role-management/get-all.asciidoc b/docs/api/role-management/get-all.asciidoc
diff --git a/docs/api/role-management/get.asciidoc b/docs/api/role-management/get.asciidoc