diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 9eadf94192..a74e6d5bc5 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -2689,6 +2689,11 @@ force_evacuate:
       instance to the specified host. It is recommended to either not specify
       a host so that the scheduler will pick one, or specify a host without
       ``force=True`` set.
+
+      Furthermore, this should not be specified when evacuating instances
+      managed by a clustered hypervisor driver like ironic since you
+      cannot specify a node, so the compute service will pick a node randomly
+      which may not be able to accomodate the instance.
   in: body
   required: false
   type: boolean