You're looking at an unstable version of this specification. Unstable specifications may change at any time without notice.
Changes since last release
| Git commit | https://github.com/matrix-org/matrix-spec/tree/be21886 |
|---|---|
| Checklist | checklist.md |
Client-Server API
New Endpoints
- Add
GET /_matrix/client/v1/admin/lock/{userId}, as per MSC4323. (#2278) - Add
PUT /_matrix/client/v1/admin/lock/{userId}, as per MSC4323. (#2278) - Add
GET /_matrix/client/v1/admin/suspend/{userId}, as per MSC4323. (#2278) - Add
PUT /_matrix/client/v1/admin/suspend/{userId}, as per MSC4323. (#2278)
Backwards Compatible Changes
- Add the account management capabilities for the OAuth 2.0 authentication API, as per MSC4191. (#2270)
- Add OAuth 2.0 aware clients, as per MSC3824. (#2272)
- Add administrator endpoints to lock and suspend server-local users and add the
m.account_managementcapability, as per MSC4323. (#2278) - Add
m.recent_emojiaccount data event to track recently used emoji as per MSC4356. (#2291) - Add
m.forget_forced_upon_leavecapability for servers to transparently auto-forget rooms that the user leaves as per MSC4267. (#2292) - Add support for
m.room.redactionevents at thePUT /rooms/{roomId}/send/{eventType}/{txnId}endpoint, as per MSC4169. (#2298) - Clients supporting the
olHTML element must also support thestartattribute, as per MSC4313. (#2299) - Add recommendation about excluding non-cross-signed devices from encrypted conversations, as per MSC4153. (#2301)
- Add invite blocking, as per MSC4380. (#2305)
Spec Clarifications
- The optional
submit_urlresponse parameter of the/requestTokenendpoints uses the same request and response parameters and error codes as the Identity Service API’sPOST /_matrix/identity/v2/validate/email/submitToken, as per MSC4183. (#2277) - Update non-historic mentions of matrix-doc repo to matrix-spec/-proposals. Contributed by @HarHarLinks. (#2280)
- Remove unintended TeX formatting. Contributed by @HarHarLinks. (#2283)
- Clarify the requiredness of
event_idinpredecessor. (#2304) - Clarify terminology for keys in cross-signing module. (#2306)
- Add 404 responses to the OpenAPI of
GET /loginandGET /auth_metadataendpoints. The responses were already defined in text but not written in OpenAPI. (#2316)
Server-Server API
Removed Endpoints
Spec Clarifications
- Clarify what the
minimum_valid_until_tsfield means when it is set in key queries. (#2191) - Specify validation for PDUs passed to and returned from federation membership endpoints. (#2284)
- Specify that callers of
/_matrix/federation/v1/openid/userinfomust validate the returned user ID. (#2288) - Change
m.signing_updatetypo tom.signing_key_update. Contributed by @velikopter (#2300)
Application Service API
No significant changes.
Identity Service API
Spec Clarifications
- Clarify the error codes that can be returned with a 400 HTTP status code by the
POST /_matrix/identity/v2/validate/email/submitTokenandPOST /_matrix/identity/v2/validate/msisdn/submitTokenendpoints, introducing theM_TOKEN_INCORRECTerror code, as per MSC4183. (#2277)
Push Gateway API
No significant changes.
Room Versions
Spec Clarifications
- Clarify meaning of floating-point powerlevels. (#2297)
- Remove the post-1.16 release note for room version 12. (#2303)
Appendices
Spec Clarifications
- Add identifier pronunciation guidelines. Contributed by @HarHarLinks. (#2307)
Internal Changes/Tooling
Backwards Compatible Changes
- Include the spec release version in the filenames in the tarballs generated by CI. (#2276)
Spec Clarifications
- Clarify vendor prefixing requirements. (#2222)
- Auto-create draft releases when building release tags. (#2275)
- Replace the Twitter link in the footer with our BlueSky and Mastodon socials. (#2282)
- Upgrade to docsy v0.13.0. (#2287)
- Updates to the release documentation. (#2289)
- Remove unused leftover CSS files. (#2290)
- Update the footer social links to match matrix.org. Contributed by @HarHarLinks. (#2317)