From d91395cf9fe0c368436fd810a11959412b2aa979 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Tue, 28 Aug 2018 19:33:45 -0600
Subject: [PATCH 1/2] Document 403 error for sending state events

Fixes https://github.com/matrix-org/matrix-doc/issues/1399
---
 api/client-server/room_state.yaml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/api/client-server/room_state.yaml b/api/client-server/room_state.yaml
index c04fb803..bda66eb8 100644
--- a/api/client-server/room_state.yaml
+++ b/api/client-server/room_state.yaml
@@ -87,6 +87,16 @@ paths:
                 type: string
                 description: |-
                   A unique identifier for the event.
+        403:
+          description: |-
+            The sender doesn't have permission to send the event into the room.
+          schema:
+            $ref: "definitions/errors/error.yaml"
+          examples:
+            application/json: {
+              "errcode": "M_FORBIDDEN",
+              "error": "You do not have permission to send the event."
+            }
       tags:
         - Room participation
   "/rooms/{roomId}/state/{eventType}":
@@ -142,5 +152,15 @@ paths:
                 type: string
                 description: |-
                   A unique identifier for the event.
+        403:
+          description: |-
+            The sender doesn't have permission to send the event into the room.
+          schema:
+            $ref: "definitions/errors/error.yaml"
+          examples:
+            application/json: {
+              "errcode": "M_FORBIDDEN",
+              "error": "You do not have permission to send the event."
+            }
       tags:
         - Room participation

From d1add1f58c983c5ece0994c7d7c3ef80d0841d0a Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Tue, 28 Aug 2018 19:34:58 -0600
Subject: [PATCH 2/2] Changelog

---
 changelogs/client_server/newsfragments/1590.clarification | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changelogs/client_server/newsfragments/1590.clarification

diff --git a/changelogs/client_server/newsfragments/1590.clarification b/changelogs/client_server/newsfragments/1590.clarification
new file mode 100644
index 00000000..27999193
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1590.clarification
@@ -0,0 +1 @@
+Document the 403 error for sending state events.