diff --git a/swagger/client-server/api-docs-rooms b/swagger/client-server/api-docs-rooms
index f9434afd..1c306142 100644
--- a/swagger/client-server/api-docs-rooms
+++ b/swagger/client-server/api-docs-rooms
@@ -771,7 +771,7 @@
       "properties": {
         "visibility": {
           "type": "string",
-          "description": "Enum: The room visibility.",
+          "description": "Enum: The room visibility. The room_alias_name is required if the visibility is public; without it the room will remain private.",
           "required": false,
           "enum": [
             "public",