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/6e16a19 |
---|---|
Checklist | checklist.md |
Client-Server API
Deprecations
Backwards Compatible Changes
- Update user profile endpoints to handle custom fields, and add a new
m.profile_fields
capability,as per MSC4133. (#2071) - Add
format
query parameter toGET /state/{eventType}/{stateKey}
to allow fetching metadata of a specific state event. (#2175) - Add the
use_state_after
query parameter andstate_after
response property toGET /sync
, as per MSC4222. (#2187) - When creating rooms with room version 12, the
trusted_private_chat
preset should merge the invitees into the suppliedcontent.additional_creators
in the resulting room, as per MSC4289. (#2193) - When creating rooms with room version 12, the initial power levels will restrict the ability to upgrade rooms by default, as per MSC4289. (#2193)
- In room version 12, room IDs no longer have a domain component as per MSC4291. (#2193)
- When upgrading rooms to room version 12,
additional_creators
may be specified on thePOST /_matrix/client/v3/rooms/{roomId}/upgrade
endpoint, as per MSC4289. (#2193) - In room version 12, the power level of room creators is now infinitely high as per MSC4289. (#2193)
Spec Clarifications
- Declare the event schemas to follow JSON Schema spec 2020-12. (#2132)
- Clarify that
format
is required ifformatted_body
is specified. (#2167) - The
latest_event
in an aggregated set of thread events uses the same format as the event itself. (#2169) - Fix various typos throughout the specification. (#2171, #2177, #2179)
- Minor fixes to JSON schemas. (#2182)
- Fix
/sync
flow referencing incorrect parameter to use with/messages
. (#2195)
Server-Server API
No significant changes.
Application Service API
Spec Clarifications
- Declare the Application Service Registration schema to follow JSON Schema spec 2020-12. (#2132)
- Minor fixes to JSON schemas. (#2182)
Identity Service API
No significant changes.
Push Gateway API
No significant changes.
Room Versions
Backwards Compatible Changes
- Room IDs in room version 12 are now the event ID of the create event with the normal room ID sigil (
!
), as per MSC4291. (#2193) - The default room version is now room version 12, though servers SHOULD keep using room version 11 for a little while, as per MSC4304. (#2193)
- State Resolution is updated in room version 12 to reduce the opportunity for “state resets”, as per MSC4297. (#2193)
- Room creators are formalized in room version 12 and have infinitely high power level, as per MSC4289. (#2193)
- Add room version 12 as per MSC4304. (#2193, #2199)
Spec Clarifications
- In room versions 1 through 12, an event’s
auth_events
have always needed to belong to the same room as per MSC4307. (#2193)
Appendices
Backwards Compatible Changes
- Room IDs can now appear without a domain component in room version 12, as per MSC4291. (#2193)
Internal Changes/Tooling
Backwards Compatible Changes
Spec Clarifications
- Upgrade the docsy theme to version 0.12.0. (#2160)
- GitHub actions are now building the OpenAPI
spec/identity-service-api/api.json
file. (#2172) - Specify a correct spelling for “display name”. (#2189)
- Clarify that clients should replace events with the most recent replacement by origin_server_ts. (#2190)