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/5b3f6b1
Checklist	checklist.md

Client-Server API

New Endpoints

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)
Specify encrypted history sharing, as per MSC4268. (#2399)

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)
Fix various typos throughout the specification. (#2351, #2389)
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)
Clarify definitions of EncryptedFile structure. (#2398)

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)
Fix various typos throughout the specification. (#2351)
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)

Spec Clarifications

Spec Clarifications

No significant changes.

Spec Clarifications

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)

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)
Clarify matrix.to RFC 3986 percent encoding requirements. Contributed by @HarHarLinks. (#2395)
Add specification of URL-safe unpadded Base64. (#2398)

Backwards Compatible Changes

Spec Clarifications