diff --git a/data/api/client-server/room_state.yaml b/data/api/client-server/room_state.yaml
index 1c03dbdd..53089443 100644
--- a/data/api/client-server/room_state.yaml
+++ b/data/api/client-server/room_state.yaml
@@ -20,8 +20,8 @@ paths:
     put:
       summary: Send a state event to the given room.
       description: |
-        State events can be sent using this endpoint.  These events will be
-        overwritten if `<room id>`, `<event type>` and `<state key>` all
+        State events can be sent using this endpoint.  These events will be appended
+        and the state overwritten if `<room id>`, `<event type>` and `<state key>` all
         match.
 
         Requests to this endpoint **cannot use transaction IDs**