From 40d5e48716c410b29c49ebd2e0c9ef1b9b57ca5f Mon Sep 17 00:00:00 2001
From: Johannes Marbach <n0-0ne+github@mailbox.org>
Date: Wed, 10 Jul 2024 18:13:37 +0200
Subject: [PATCH] Add missing references in capabilities table (#1897)

* Add missing references in capabilities table

Fixes: #1548
Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>

* Add changelog

---------

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
---
 .../newsfragments/1897.clarification          |  1 +
 data/api/client-server/capabilities.yaml      | 31 +++++++++++++------
 2 files changed, 23 insertions(+), 9 deletions(-)
 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.
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