[DRAFT] Security feature SuperAdmin documentation updates

_security/access-control/users-roles.md

@@ -242,3 +242,40 @@ Map the role to your user:
 1. Choose the **Mapped users** tab and **Manage mapping**.
 1. For **Internal users**, add your bulk access user.
 1. Choose **Map**.
+
+## SuperAdmin role
+
+The `superAdmin` role enables adding, updating, and deleting reserved configurations like roles, roles_mapping, internal_users, action_groups, and tenants. Previously, these configurations were loaded from default YAML files. Now, the `superAdmin` role now has the privilege to add, update, and delete by using API calls.
+
+### Example API calls:
+Following are examples of API calls for `superAdmin` actions:
+
+Adding a Reserved Configuration:
+```
+curl -X PUT https://localhost:9200/_opendistro/_security/api/roles/new_role -k -H 'Content-Type: application/json' -d '{
+  "reserved": true,
+  "description": "Description of the role",
+  "cluster_permissions": [],
+  "index_permissions": [],
+  "tenant_permissions": []
+}'
+```
+{% include copy.html %}
+
+Updating a Reserved Configuration:
+```
+curl -X PUT https://localhost:9200/_opendistro/_security/api/roles/new_role -k -H 'Content-Type: application/json' -d '{
+  "reserved": true,
+  "description": "Updated description",
+  "cluster_permissions": [],
+  "index_permissions": [],
+  "tenant_permissions": []
+}'
+```
+{% include copy.html %}
+
+Deleting a Reserved Configuration:
+```
+curl -X DELETE https://localhost:9200/_opendistro/_security/api/roles/new_role -k
+```
+{% include copy.html %}