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/9d809b6
Checklistchecklist.md

Client-Server API

New Endpoints

  • Add GET /_matrix/client/v1/mutual_rooms, as per MSC2666. (#2367)

Backwards Compatible Changes

  • Specify unsigned.replaces_state in client-formatted events. Contributed by @nexy7574. (#2345)
  • Specify m.key_backup account data, as per MSC4287. (#2354)
  • The room directory now returns rooms in a server-defined order rather than largest first, as per MSC4423. (#2392)
  • Add support for image packs (m.room.image_pack and m.image_pack.rooms), allowing custom emoticons and stickers to be organised into packs and shared between users. (#2397)

Spec Clarifications

  • Clarify SAS commitment calculation for m.key.verification.accept messages. (#2344)
  • Clarify formats of string types. (#2347, #2349, #2358, #2359, #2370, #2374, #2375, #2376)
  • Fix ordering of common error codes. (#2348)
  • Clarify how to find via parameter when following room upgrades. (#2352)
  • Clarify that room messages can be encrypted. (#2371)
  • Clarify how to paginate messages using the pagination tokens returned by GET /rooms/{roomId}/context/{eventId}. (#2372)
  • Clarify allowed characters in mxc:// URIs. (#2377)
  • Add link to RFC 9700 OAuth 2.0 Best Current Practices. (#2379)
  • Add links from the Client-Server spec to the Olm message definitions. (#2381)
  • Disambiguate placeholder descriptions in OlmPayload example. (#2382)
  • Replace “Olm message” with “event encrypted using Olm” where not referring to the Olm message format. (#2383)
  • Removed unused components in OpenAPI definitions. (#2386)
  • Fix various typos throughout the specification. (#2389)

Server-Server API

Backwards Compatible Changes

  • The room directory now returns rooms in a server-defined order rather than largest first, as per MSC4423. (#2392)

Spec Clarifications

  • Clarify the behaviour and response format of GET /_matrix/federation/v1/query/profile. (#2326)
  • Clarify that server ACLs are case-insensitive, as per MSC4436. (#2334)
  • Clarify how multiple signatures should be handled during signature verification. Contributed by @nexy7574. (#2341)
  • Clarify that policy servers might share a name with event origins, and that servers should avoid overwriting/discarding signatures for the event origin when getting a policy server signature. (#2385)

Application Service API

No significant changes.

Identity Service API

No significant changes.

Push Gateway API

No significant changes.

Room Versions

No significant changes.

Olm & Megolm

Spec Clarifications

  • Update links to Olm in the Megolm section to point to the Matrix spec. (#2361)
  • Fix various typos throughout the specification. (#2369)
  • Update link from whispersystems.org to signal.org in the olm documentation (#2387)

Appendices

Spec Clarifications

  • Update the canonical JSON grammar with case sensitive strings and ABNF builtins to be easier to understand. (#2368)
  • Fix various typos throughout the specification. (#2369)

Internal Changes/Tooling

Backwards Compatible Changes

  • Add page search widget. (#2331)

Spec Clarifications

  • Update and fix GitHub Actions. (#2343, #2369)
  • Upgrade Docsy theme to v0.14.3. (#2346)
  • Configure a new changelog section for the Olm & Megolm specs. (#2364)
  • Clarify use of UK vs US English in documentation style doc. (#2366)
  • Ignore typos in copyright statements. (#2373)