Document StateEvent for /createRoom (#1329)

api/client-server/create_room.yaml

@@ -150,10 +150,14 @@ paths:
                   properties:
                     type:
                       type: string
+                      description: The type of event to send.
                     state_key:
                       type: string
+                      description: The state_key of the state event. Defaults to an empty string.
                     content:
                       type: object
+                      description: The content of the event.
+                  required: ["type", "content"]
               preset:
                 type: string
                 enum: ["private_chat", "public_chat", "trusted_private_chat"]

changelogs/client_server.rst

@@ -37,6 +37,8 @@ Unreleased changes
     (`#1152 <https://github.com/matrix-org/matrix-doc/pull/1152>`_).
   - Mark ``GET /rooms/{roomId}/members`` as requiring authentication
     (`#1245 <https://github.com/matrix-org/matrix-doc/pull/1244>`_).
+  - Describe ``StateEvent`` for ``/createRoom``
+    (`#1329 <https://github.com/matrix-org/matrix-doc/pull/1329>`_).
 
 - Changes to the API which will be backwards-compatible for clients: