diff --git a/content/client-server-api/_index.md b/content/client-server-api/_index.md index 7dfc45989b9..cfc4e293066 100644 --- a/content/client-server-api/_index.md +++ b/content/client-server-api/_index.md @@ -1249,6 +1249,79 @@ using an `unstable` version. When this capability is not listed, clients should use `"1"` as the default and only stable `available` room version. +### `m.set_displayname` capability + +This capability has a single flag, `enabled`, to denote whether the user +is able to change their own display name via profile endpoints. Cases for +disabling might include users mapped from external identity/directory +services, such as LDAP. + +Note that this is well paired with the `m.set_avatar_url` capability. + +When not listed, clients should assume the user is able to change their +display name. + +An example of the capability API's response for this capability is: + +```json +{ + "capabilities": { + "m.set_displayname": { + "enabled": false + } + } +} +``` + +### `m.set_avatar_url` capability + +This capability has a single flag, `enabled`, to denote whether the user +is able to change their own avatar via profile endpoints. Cases for +disabling might include users mapped from external identity/directory +services, such as LDAP. + +Note that this is well paired with the `m.set_displayname` capability. + +When not listed, clients should assume the user is able to change their +avatar. + +An example of the capability API's response for this capability is: + +```json +{ + "capabilities": { + "m.set_avatar_url": { + "enabled": false + } + } +} +``` + +### `m.3pid_changes` capability + +This capability has a single flag, `enabled`, to denote whether the user +is able to add, remove, or change 3PID associations on their account. Note +that this only affects a user's ability to use the +[Admin Contact Information](#adding-account-administrative-contact-information) +API, not endpoints exposed by an Identity Service. Cases for disabling +might include users mapped from external identity/directory services, +such as LDAP. + +When not listed, clients should assume the user is able to modify their 3PID +associations. + +An example of the capability API's response for this capability is: + +```json +{ + "capabilities": { + "m.3pid_changes": { + "enabled": false + } + } +} +``` + ## Filtering Filters can be created on the server and can be passed as a parameter to