diff --git a/python/pyspark/sql/connect/proto/catalog_pb2.pyi b/python/pyspark/sql/connect/proto/catalog_pb2.pyi
index 625a929896619..2d81a7fb97e8d 100644
--- a/python/pyspark/sql/connect/proto/catalog_pb2.pyi
+++ b/python/pyspark/sql/connect/proto/catalog_pb2.pyi
@@ -50,7 +50,7 @@ else:
 DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 class Catalog(google.protobuf.message.Message):
-    """Catalog messages are all meant to be internal."""
+    """Catalog messages are marked as unstable."""
 
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
diff --git a/python/pyspark/sql/connect/proto/relations_pb2.pyi b/python/pyspark/sql/connect/proto/relations_pb2.pyi
index 199fc19351361..f19e64ecd9fbc 100644
--- a/python/pyspark/sql/connect/proto/relations_pb2.pyi
+++ b/python/pyspark/sql/connect/proto/relations_pb2.pyi
@@ -163,7 +163,7 @@ class Relation(google.protobuf.message.Message):
     def describe(self) -> global___StatDescribe: ...
     @property
     def catalog(self) -> pyspark.sql.connect.proto.catalog_pb2.Catalog:
-        """Catalog API (internal-only)"""
+        """Catalog API (experimental / unstable)"""
     @property
     def unknown(self) -> global___Unknown: ...
     def __init__(