From 0ce27bb5d3534bc7f436430c3a9a2d3bbaca3530 Mon Sep 17 00:00:00 2001
From: Johannes Marbach <n0-0ne+github@mailbox.org>
Date: Thu, 4 Jul 2024 15:52:48 +0200
Subject: [PATCH 1/2] Add missing references in capabilities table

Fixes: #1548
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
---
 data/api/client-server/capabilities.yaml | 31 +++++++++++++++++-------
 1 file changed, 22 insertions(+), 9 deletions(-)

diff --git a/data/api/client-server/capabilities.yaml b/data/api/client-server/capabilities.yaml
index 99f079627..fc5b47e27 100644
--- a/data/api/client-server/capabilities.yaml
+++ b/data/api/client-server/capabilities.yaml
@@ -46,16 +46,8 @@ paths:
                       type: object
                     properties:
                       m.change_password:
-                        type: object
+                        $ref: '#/components/schemas/booleanCapability'
                         description: Capability to indicate if the user can change their password.
-                        title: ChangePasswordCapability
-                        properties:
-                          enabled:
-                            type: boolean
-                            description: True if the user can change their password, false otherwise.
-                            example: false
-                        required:
-                          - enabled
                       m.room_versions:
                         type: object
                         description: The room versions the server supports.
@@ -78,6 +70,16 @@ paths:
                         required:
                           - default
                           - available
+                      m.set_displayname:
+                        $ref: '#/components/schemas/booleanCapability'
+                        description: Capability to indicate if the user can change their display name.
+                      m.set_avatar_url:
+                        $ref: '#/components/schemas/booleanCapability'
+                        description: Capability to indicate if the user can change their avatar.
+                      m.3pid_changes:
+                        $ref: '#/components/schemas/booleanCapability'
+                        description: Capability to indicate if the user can change 3PID associations
+                          on their account.
               examples:
                 response:
                   value: {
@@ -125,3 +127,14 @@ components:
       $ref: definitions/security.yaml#/accessTokenQuery
     accessTokenBearer:
       $ref: definitions/security.yaml#/accessTokenBearer
+  schemas:
+    booleanCapability:
+      type: object
+      title: BooleanCapability
+      properties:
+        enabled:
+          type: boolean
+          description: True if the user can perform the action, false otherwise.
+          example: false
+      required:
+        - enabled

From 411b1b2aed573af92dc6bef5a8fe88649bda73e9 Mon Sep 17 00:00:00 2001
From: Johannes Marbach <n0-0ne+github@mailbox.org>
Date: Thu, 4 Jul 2024 15:55:27 +0200
Subject: [PATCH 2/2] Add changelog

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

diff --git a/changelogs/client_server/newsfragments/1897.clarification b/changelogs/client_server/newsfragments/1897.clarification
new file mode 100644
index 000000000..7bc903ba1
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1897.clarification
@@ -0,0 +1 @@
+Add missing references to `m.set_displayname`, `m.set_avatar_url` and `m.3pid_changes` in capabilities table.