Add the m.tags event to a ``private_user_data`` key rather than including it under the ``ephemeral`` key

api/client-server/v2_alpha/sync.yaml

@@ -121,6 +121,14 @@ paths:
                             e.g. typing.
                           allOf:
                             - $ref: "definitions/event_batch.json"
+                        private_user_data:
+                          title: Private User Data
+                          type: object
+                          description: |-
+                            The private data that this user has attached to
+                            this room.
+                          allOf:
+                          - $ref: "definitions/event_batch.json"
                   invited:
                     title: Invited
                     type: object
@@ -253,11 +261,18 @@ paths:
                       "ephemeral": {
                         "events": [
                           {
-                            "room_id": "!726s6s6q:example.com",
                             "type": "m.typing",
                             "content": {"user_ids": ["@alice:example.com"]}
                           }
                         ]
+                      },
+                      "private_user_data": {
+                        "events": [
+                          {
+                            "type": "m.tags",
+                            "content": {"tags": ["work"]}
+                          }
+                        ]
                       }
                     }
                   },

specification/modules/tags.rst

@@ -10,8 +10,8 @@ user that set them but are shared across all their devices.
 Events
 ------
 
-The tags on a room are passed as single ``m.tag`` event in the ``ephemeral``
+The tags on a room are passed as single ``m.tag`` event in the
-section of a v2 room sync.
+``private_user_data`` section of a room in v2 sync.
 
 {{m_tag_event}}