You're looking at an unstable version of this specification. Unstable specifications may change at any time without notice.

Switch to the current stable release.

Changes since last release

Git commithttps://github.com/matrix-org/matrix-spec/tree/a6da944
Checklistchecklist.md

Client-Server API

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 m.recent_emoji account data event to track recently used emoji as per MSC4356. (#2291)
  • Add m.forget_forced_upon_leave capability for servers to transparently auto-forget rooms that the user leaves as per MSC4267. (#2292)
  • Add support for m.room.redaction events at the PUT /rooms/{roomId}/send/{eventType}/{txnId} endpoint, as per MSC4169. (#2298)
  • Clients supporting the ol HTML element must also support the start attribute, as per MSC4313. (#2299)
  • Add invite blocking, as per MSC4380. (#2305)

Spec Clarifications

  • The optional submit_url response parameter of the /requestToken endpoints uses the same request and response parameters and error codes as the Identity Service API’s POST /_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)

Server-Server API

Spec Clarifications

  • Clarify what the minimum_valid_until_ts field means when it is set in key queries. (#2191)
  • Specify that callers of /_matrix/federation/v1/openid/userinfo must validate the returned user ID. (#2288)
  • Change m.signing_update typo to m.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/submitToken and POST /_matrix/identity/v2/validate/msisdn/submitToken endpoints, introducing the M_TOKEN_INCORRECT error code, as per MSC4183. (#2277)

Push Gateway API

No significant changes.

Room Versions

Spec Clarifications

  • 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)