From e018a60843937454d0a63ecc44dab14090bca743 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Commaille?= <zecakeh@tedomum.fr>
Date: Thu, 15 Jan 2026 10:41:07 +0100
Subject: [PATCH] Use definition shortcode for account management server
 metadata
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
---
 content/client-server-api/_index.md              |  7 ++-----
 .../oauth2-account-management-action.yaml        |  9 +++++++++
 ...auth2-account-management-server-metadata.yaml | 16 ++++++++++++++++
 3 files changed, 27 insertions(+), 5 deletions(-)
 create mode 100644 data/schemas/oauth2-account-management-action.yaml
 create mode 100644 data/schemas/oauth2-account-management-server-metadata.yaml

diff --git a/content/client-server-api/_index.md b/content/client-server-api/_index.md
index 468f2ae3..b4b630a8 100644
--- a/content/client-server-api/_index.md
+++ b/content/client-server-api/_index.md
@@ -2277,12 +2277,9 @@ in a browser.
 ##### Account management URL discovery
 
 The [OAuth 2.0 authorization server metadata](#server-metadata-discovery) is
-extended to include the following fields:
+extended to include the following **optional** fields.
 
-| Field                                  | Description                                                                                     |
-|----------------------------------------|-------------------------------------------------------------------------------------------------|
-| `account_management_uri`               | The URL where the user is able to access the account management capabilities of the homeserver. |
-| `account_management_actions_supported` | An array of actions that the account management URL supports, as defined below.                 |
+{{% definition path="schemas/oauth2-account-management-server-metadata" %}}
 
 ##### Account management URL parameters
 
diff --git a/data/schemas/oauth2-account-management-action.yaml b/data/schemas/oauth2-account-management-action.yaml
new file mode 100644
index 00000000..a63660fc
--- /dev/null
+++ b/data/schemas/oauth2-account-management-action.yaml
@@ -0,0 +1,9 @@
+type: string
+enum:
+  - "org.matrix.profile"
+  - "org.matrix.devices_list"
+  - "org.matrix.device_view"
+  - "org.matrix.device_delete"
+  - "org.matrix.account_deactivate"
+  - "org.matrix.cross_signing_reset"
+description: An action that the account management URL supports.
diff --git a/data/schemas/oauth2-account-management-server-metadata.yaml b/data/schemas/oauth2-account-management-server-metadata.yaml
new file mode 100644
index 00000000..89e740ad
--- /dev/null
+++ b/data/schemas/oauth2-account-management-server-metadata.yaml
@@ -0,0 +1,16 @@
+type: object
+title: OAuth 2.0 Server Metadata Account Management Extension
+properties:
+  account_management_uri:
+    type: string
+    format: uri
+    description: |-
+      The URL where the user is able to access the account management capabilities of the
+      homeserver.
+  account_management_actions_supported:
+    type: array
+    description: |-
+      List of [actions](/client-server-api/#account-management-url-actions) that the account
+      management URL supports.
+    items:
+      $ref: ./oauth2-account-management-action.yaml