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

Client-Server API

New Endpoints

  • Add POST /_matrix/client/v3/rooms/{roomId}/report as per MSC4151. (#1938)

Backwards Compatible Changes

  • Remove reply fallbacks, as per MSC2781. (#1994)
  • Add PATCH and HEAD to the allowed HTTP methods in CORS responses, as per MSC4138. (#1995)

Spec Clarifications

  • The reason parameter in POST /_matrix/client/v3/rooms/{roomId}/report/{eventId} can be omitted instead of left blank as per MSC2414. (#1938)
  • Correct OpenAPI specification for query parameters to GET /_matrix/client/v3/thirdparty/location/{protocol} endpoint. (#1947)
  • Sort VoIP events semantically. (#1967)
  • Clarify that servers must forward custom keys in PusherData when sending notifications to the push gateway. (#1973)
  • Clarify formats of string types. (#1978, #1979, #1980)
  • Clarify that the async upload endpoint will return 404 in some cases. (#1983)
  • Remove distinction between StateFilter and RoomEventFilter. (#2015)
  • Use json instead of json5 for syntax highlighting. (#2017)

Server-Server API

Spec Clarifications

  • Add 403 error response to /_matrix/federation/v1/state_ids/{roomId}. (#1926)

Application Service API

No significant changes.

Identity Service API

No significant changes.

Push Gateway API

Spec Clarifications

  • Document the schema of PusherData. (#1968)
  • The path of HTTP pusher URLs is fixed to /_matrix/push/v1/notify. (#1974)

Room Versions

No significant changes.

Appendices

Spec Clarifications

  • Remove note about reference implementations. (#1966)

Internal Changes/Tooling

Spec Clarifications

  • Add x-weight property for sorting events rendered with the event-group shortcode. (#1967)
  • Enforce consistent vertical spacing between paragraphs in endpoint definitions. (#1969, #2005)
  • Remove boxes/added-in-paragraph shortcode. (#1970)
  • Remove withVersioning parameter of rver-fragment shortcode. (#1971)
  • Remove span element from added-in and changed-in shortcodes. (#1972)
  • Fix formatting of added-in and changed-in shortcodes by using % delimiter. (#1975)
  • Remove CSS workaround for scroll-anchoring. (#1976)
  • Rename custom-formats.yaml to string-formats.yaml and update its docs. (#1977)
  • Fix relative URLs when serving the specification with a custom baseURL. (#1984, #1997)
  • Rename .htmltest.yaml to .htmltest.yml. (#1985)
  • Improve the JS script to highlight the current ToC entry. (#1991, #2002)
  • Upgrade docsy to 0.11.0 and hugo to 0.139.0. (#1996, #2007)
  • Improve the quality of the rendered diagrams (#1999)
  • Update the Inter font and allow the browser to render the page before it is loaded (#2000)
  • Use a proper Matrix favicon (#2001)
  • Clean up unused CSS classes in openapi/render-operation partial. (#2003)
  • Fix changed-in partial when used with multiple paragraphs. (#2006)
  • Remove trailing slash on void HTML elements. (#2009)