Add capabilities described by MSC3283 (#3614)

* Add capabilities described by MSC3283

MSC: https://github.com/matrix-org/matrix-doc/pull/3283

* changelog
pull/3621/head
Travis Ralston 2 years ago committed by GitHub
parent e4057072bd
commit 0ee58100c4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -0,0 +1 @@
Add new `m.set_displayname`, `m.set_avatar_url`, and `m.3pid_changes` capabilities as per [MSC3283](https://github.com/matrix-org/matrix-doc/pull/3283).

@ -1293,6 +1293,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

Loading…
Cancel
Save