diff --git a/api/client-server/pushrules.yaml b/api/client-server/pushrules.yaml
index d82190b7..d11d1ef7 100644
--- a/api/client-server/pushrules.yaml
+++ b/api/client-server/pushrules.yaml
@@ -612,7 +612,7 @@ paths:
         - in: body
           name: body
           description: |
-            Whether the push rule is enabled or not.
+            The action(s) to perform when the conditions for this rule are met.
           required: true
           schema:
             type: object
@@ -620,6 +620,10 @@ paths:
               actions:
                 type: array
                 description: The action(s) to perform for this rule.
+                items:
+                  type: string
+                  enum: ["notify", "dont_notify", "coalesce", "set_tweak"]
+                  # TODO: type: object e.g. {"set_sound":"beeroclock.wav"} :/
             required: ["actions"]
             example: |-
               {
diff --git a/api/client-server/tags.yaml b/api/client-server/tags.yaml
index 404ed7ef..1324b865 100644
--- a/api/client-server/tags.yaml
+++ b/api/client-server/tags.yaml
@@ -116,7 +116,7 @@ paths:
       description: |-
         Remove a tag from the room.
       security:
-        - access_token: []
+        - accessToken: []
       parameters:
         - in: path
           type: string