diff --git a/src/s2_sdk/_ops.py b/src/s2_sdk/_ops.py
index 03a9490..c018bc0 100644
--- a/src/s2_sdk/_ops.py
+++ b/src/s2_sdk/_ops.py
@@ -677,6 +677,11 @@ async def ensure_stream(
 
         Returns:
             Information about the ensured stream.
+
+        Note:
+            ``name`` must be unique within the basin. It can be an arbitrary string
+            up to 512 characters. ``/`` is recommended as a delimiter for
+            hierarchical naming.
         """
         json = stream_config_to_json(config)
         response = await self._retrier(