diff --git a/mostlyai/sdk/client/api.py b/mostlyai/sdk/client/api.py
index b23c6ec4..66b19e68 100644
--- a/mostlyai/sdk/client/api.py
+++ b/mostlyai/sdk/client/api.py
@@ -649,6 +649,8 @@ def train(
             ```
 
         Example with constraints to preserve valid combinations and enforce inequalities:
+            Note: Each column can only appear in one constraint across all constraint types.
+            This applies to all columns referenced in any constraint, regardless of constraint type.
             ```python
             # constraints ensure that synthetic data only contains combinations of values that existed in training data
             # and enforce logical relationships like departure_time < arrival_time