diff --git a/api-ref/source/v2/volumes-v2-volumes-actions.inc b/api-ref/source/v2/volumes-v2-volumes-actions.inc
index 43121dbb23a..5aa78540573 100644
--- a/api-ref/source/v2/volumes-v2-volumes-actions.inc
+++ b/api-ref/source/v2/volumes-v2-volumes-actions.inc
@@ -304,6 +304,11 @@ Forces a volume to detach. Specify the ``os-force_detach`` action in the request
 Rolls back an unsuccessful detach operation after you disconnect
 the volume.
 
+Policy defaults enable only users with the administrative role to
+perform this operation. Cloud providers can change these permissions
+through the ``volume_extension:volume_admin_actions:force_detach`` rule in
+the ``policy.json`` file.
+
 Normal response codes: 202
 
 
diff --git a/api-ref/source/v3/volumes-v3-volumes-actions.inc b/api-ref/source/v3/volumes-v3-volumes-actions.inc
index 7cdd22cf544..bd23e6333ab 100644
--- a/api-ref/source/v3/volumes-v3-volumes-actions.inc
+++ b/api-ref/source/v3/volumes-v3-volumes-actions.inc
@@ -338,6 +338,11 @@ Forces a volume to detach. Specify the ``os-force_detach`` action in the request
 Rolls back an unsuccessful detach operation after you disconnect
 the volume.
 
+Policy defaults enable only users with the administrative role to
+perform this operation. Cloud providers can change these permissions
+through the ``volume_extension:volume_admin_actions:force_detach`` rule in
+the ``policy.json`` file.
+
 Normal response codes: 202