diff --git a/docs/api.md b/docs/api.md
index f38a729e4b..842764eab1 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -40457,7 +40457,8 @@ TargetAllocator indicates a value which determines whether to spawn a target all
         <td>
           AllocationStrategy determines which strategy the target allocator should use for allocation.
 The current options are least-weighted, consistent-hashing and per-node. The default is
-consistent-hashing.<br/>
+consistent-hashing.
+WARNING: The per-node strategy currently ignores targets without a Node, like control plane components.<br/>
           <br/>
             <i>Enum</i>: least-weighted, consistent-hashing<br/>
             <i>Default</i>: consistent-hashing<br/>