Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-02-14 18:13:47 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Use definition shortcode for account management URL query parameters

Browse source 
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
This commit is contained in:
Kévin Commaille 2026-01-15 10:41:45 +01:00
parent e018a60843
commit b77dd245c6
No known key found for this signature in database
GPG key ID: F26F4BE20A08255B
2 changed files with 18 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
content/client-server-api/_index.md
View file

@ -2283,16 +2283,9 @@ extended to include the following **optional** fields.
##### Account management URL parameters
The account management URL MAY accept the following query parameters:
The account management URL MAY accept the following minimum query parameters.
| Parameter | Description |
|-------------|---------------------------------------------------------------------------------------------------------------------------------------|
| `action` | **Optional**. The action that the user wishes to take. Must match one of the actions in `account_management_actions_supported` above. |
| `device_id` | **Optional**. Identifies a particular Matrix device ID for actions that support it. |
If the `org.matrix.device_view` or `org.matrix.device_delete` actions are
advertised as supported by the server then the server SHOULD support the
`device_id` parameter.
{{% definition path="schemas/oauth2-account-management-url" %}}
##### Account management URL actions

16
data/schemas/oauth2-account-management-url.yaml Normal file
View file

@ -0,0 +1,16 @@
type: object
title: OAuth 2.0 Account Management URL Query Parameters
properties:
action:
$ref: ./oauth2-account-management-action.yaml
description: |-
The action that the user wishes to take. Must match one of the actions advertised by the
server in [`account_management_actions_supported`](/client-server-api/#account-management-url-discovery).
device_id:
type: string
description: |-
For Matrix-specific actions, the user's device ID. Actions which don't support the device ID
will ignore it.
If the `org.matrix.device_view` or `org.matrix.device_delete` actions are advertised as
supported by the server then the server SHOULD support the `device_id` parameter.