jmagak
diff --git a/Diff for: ‎assemblies/assembly-configuring-authorization-in-rhdh.adoc
+3-9 b/Diff for: ‎assemblies/assembly-configuring-authorization-in-rhdh.adoc
+3-9
diff --git a/Diff for: ‎assemblies/assembly-managing-authorizations-by-using-the-rest-api.adoc
+25 b/Diff for: ‎assemblies/assembly-managing-authorizations-by-using-the-rest-api.adoc
+25
diff --git a/Diff for: ‎modules/authorization/con-rbac-rest-api.adoc
-119 b/Diff for: ‎modules/authorization/con-rbac-rest-api.adoc
-119
diff --git a/Diff for: ‎modules/authorization/proc-rbac-send-request-rbac-rest-api.adoc
-53 b/Diff for: ‎modules/authorization/proc-rbac-send-request-rbac-rest-api.adoc
-53
diff --git a/Diff for: ‎modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-a-rest-client.adoc
+33 b/Diff for: ‎modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-a-rest-client.adoc
+33
@@ -33,6 +33,9 @@ include::modules/authorization/proc-enabling-the-rbac-plugin.adoc[leveloffset=+1
 include::assembly-managing-authorizations-by-using-the-rhdh-web-ui.adoc[leveloffset=+1]
 
 
+include::assembly-managing-authorizations-by-using-the-rest-api.adoc[leveloffset=+1]
+
+
 include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]
 
 
@@ -55,17 +58,8 @@ include::modules/authorization/ref-rbac-conditional-policy-definition.adoc[level
 include::modules/authorization/proc-rbac-config-conditional-policy-file.adoc[leveloffset=+2]
 
 
-
 include::modules/authorization/con-user-stats-rhdh.adoc[leveloffset=+1]
 
 
 include::modules/authorization/proc-download-user-stats-rhdh.adoc[leveloffset=+2]
 
-
-include::modules/authorization/con-rbac-rest-api.adoc[leveloffset=+1]
-
-
-include::modules/authorization/proc-rbac-send-request-rbac-rest-api.adoc[leveloffset=+2]
-
-
-include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+2]
@@ -0,0 +1,25 @@
+[id='managing-authorizations-by-using-the-rest-api']
+= Managing authorizations by using the REST API
+
+To automate the maintenance of {product} permission policies and roles, you can use {product-short} role-based access control (RBAC) REST API.
+
+You can perform the following actions with the REST API:
+
+* Retrieve information about:
+** All permission policies
+** Specific permission policies
+** Specific roles
+** Static plugins permission policies
+* Create, update, or delete:
+** Permission policy
+** Role
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-curl.adoc[leveloffset=+1]
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-a-rest-client.adoc[leveloffset=+1]
+
+
+include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+1]
+
@@ -0,0 +1,33 @@
+[id='proc-rbac-sending-requests-to-the-rbac-rest-api-by-using-a-rest-client_{context}']
+= Sending requests to the RBAC REST API by using a REST client
+
+You can send RBAC REST API requests using any REST client.
+
+.Prerequisites
+* xref:enabling-and-giving-access-to-rbac[You have access to the RBAC feature].
+
+.Procedure
+include::snip-finding-bearer-token.adoc[]
+
+. In your REST client, run a command with the following parameters and review the response:
++
+--
+Authorization::
+Enter your saved authorization token.
+
+HTTP method::
+Enter the HTTP method for your xref:ref-rbac-rest-api-endpoints_{context}[API endpoint].
+
+* `GET`: To retrieve specified information from a specified resource endpoint.
+* `POST`: To create or update a resource.
+* `PUT`: To update a resource.
+* `DELETE`: To delete a resource.
+
+URL::
+Enter your {product-short} URL and xref:ref-rbac-rest-api-endpoints_{context}[API endpoint]: pass:c,a,q[{my-product-url}/__<endpoint>__], such as
+`pass:c,a,q[{my-product-url}/api/permission/policies]`.
+
+Body::
+Enter the JSON body with data that your xref:ref-rbac-rest-api-endpoints_{context}[API endpoint] might need with the HTTP `POST` request.
+--
+