diff --git a/open-api/rest-catalog-open-api.py b/open-api/rest-catalog-open-api.py
index 5de6c8969fee..e72e07e15d42 100644
--- a/open-api/rest-catalog-open-api.py
+++ b/open-api/rest-catalog-open-api.py
@@ -230,6 +230,10 @@ class BaseUpdate(BaseModel):
 
 
 class AssignUUIDUpdate(BaseUpdate):
+    """
+    Assigning a UUID to a table/view should only be done when creating the table/view. It is not safe to re-assign the UUID if a table/view already has a UUID assigned
+    """
+
     uuid: str
 
 
diff --git a/open-api/rest-catalog-open-api.yaml b/open-api/rest-catalog-open-api.yaml
index b1fbc52dd1f5..f9d76ff3c9f9 100644
--- a/open-api/rest-catalog-open-api.yaml
+++ b/open-api/rest-catalog-open-api.yaml
@@ -1696,6 +1696,7 @@ components:
             - remove-properties
 
     AssignUUIDUpdate:
+      description: Assigning a UUID to a table/view should only be done when creating the table/view. It is not safe to re-assign the UUID if a table/view already has a UUID assigned
       allOf:
         - $ref: '#/components/schemas/BaseUpdate'
         - type: object