|
|
|
|
---
|
|
|
|
|
date: 2022-09-29T00:00:00+0100
|
|
|
|
|
---
|
|
|
|
|
<!--
|
|
|
|
|
This is a header file for the generated changelog.
|
|
|
|
|
|
|
|
|
|
Variables:
|
|
|
|
|
v1.4 = Replaced by the version number (eg: v1.2)
|
|
|
|
|
September 29, 2022 = Replaced by the date (eg: April 01, 2021)
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
## v1.4
|
|
|
|
|
|
|
|
|
|
<table class="release-info">
|
|
|
|
|
<tr><th>Git commit</th><td><a href="https://github.com/matrix-org/matrix-spec/tree/v1.4">https://github.com/matrix-org/matrix-spec/tree/v1.4</a></td>
|
|
|
|
|
<tr><th>Release date</th><td>September 29, 2022</td>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<!-- Intentionally blank line to ensure headers work in the concatenated changelog -->
|
|
|
|
|
### Client-Server API
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Removed Endpoints</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Remove unused policy room sharing mechanism, as per [MSC3844](https://github.com/matrix-org/matrix-spec-proposals/pull/3844). ([#1196](https://github.com/matrix-org/matrix-spec/issues/1196))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Backwards Compatible Changes</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add a `.m.rule.room.server_acl` push rule to match `m.room.server_acl` events, as per [MSC3786](https://github.com/matrix-org/matrix-spec-proposals/pull/3786). ([#1190](https://github.com/matrix-org/matrix-spec/issues/1190), [#1201](https://github.com/matrix-org/matrix-spec/issues/1201))
|
|
|
|
|
- Add `Cross-Origin-Resource-Policy` (CORP) headers to media repository, as per [MSC3828](https://github.com/matrix-org/matrix-spec-proposals/pull/3828). ([#1197](https://github.com/matrix-org/matrix-spec/issues/1197))
|
|
|
|
|
- Copy a room's `type` when upgrading it, as per [MSC3818](https://github.com/matrix-org/matrix-spec-proposals/pull/3818). ([#1198](https://github.com/matrix-org/matrix-spec/issues/1198))
|
|
|
|
|
- Add `room_types` filter and `room_type` response to `/publicRooms`, as per [MSC3827](https://github.com/matrix-org/matrix-spec-proposals/pull/3827). ([#1199](https://github.com/matrix-org/matrix-spec/issues/1199))
|
|
|
|
|
- Add `m.replace` relations (event edits), as per [MSC2676](https://github.com/matrix-org/matrix-spec-proposals/pull/2676). ([#1211](https://github.com/matrix-org/matrix-spec/issues/1211))
|
|
|
|
|
- Add `m.read.private` receipts, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
|
|
|
|
|
- Make `m.fully_read` optional on `/read_markers`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
|
|
|
|
|
- Allow `m.fully_read` markers to be set from `/receipts`, as per [MSC2285](https://github.com/matrix-org/matrix-spec-proposals/pull/2285). ([#1216](https://github.com/matrix-org/matrix-spec/issues/1216))
|
|
|
|
|
- Add threading via `m.thread` relations, as per [MSC3440](https://github.com/matrix-org/matrix-spec-proposals/pull/3440), [MSC3816](https://github.com/matrix-org/matrix-spec-proposals/pull/3816), [MSC3856](https://github.com/matrix-org/matrix-spec-proposals/pull/3856), and [MSC3715](https://github.com/matrix-org/matrix-spec-proposals/pull/3715). ([#1254](https://github.com/matrix-org/matrix-spec/issues/1254))
|
|
|
|
|
- Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773). ([#1255](https://github.com/matrix-org/matrix-spec/issues/1255))
|
|
|
|
|
- Add `thread_id` to the `/receipt` endpoint, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771). ([#1261](https://github.com/matrix-org/matrix-spec/issues/1261))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Mention that the `/rooms/{roomId}/invite` endpoint will return a 200 response if the user is already invited to the room. ([#1084](https://github.com/matrix-org/matrix-spec/issues/1084))
|
|
|
|
|
- Fix various typos throughout the specification. ([#1135](https://github.com/matrix-org/matrix-spec/issues/1135), [#1161](https://github.com/matrix-org/matrix-spec/issues/1161), [#1164](https://github.com/matrix-org/matrix-spec/issues/1164), [#1170](https://github.com/matrix-org/matrix-spec/issues/1170), [#1180](https://github.com/matrix-org/matrix-spec/issues/1180), [#1215](https://github.com/matrix-org/matrix-spec/issues/1215), [#1238](https://github.com/matrix-org/matrix-spec/issues/1238), [#1243](https://github.com/matrix-org/matrix-spec/issues/1243), [#1263](https://github.com/matrix-org/matrix-spec/issues/1263))
|
|
|
|
|
- Describe return codes for account data endpoints, and clarify that per-room data does not inherit from the global data. ([#1155](https://github.com/matrix-org/matrix-spec/issues/1155))
|
|
|
|
|
- Clarify that policy rule globs work like ACL globs. Contributed by Nico. ([#1165](https://github.com/matrix-org/matrix-spec/issues/1165))
|
|
|
|
|
- Clarify the format of some structures in the End-to-end encryption module. ([#1166](https://github.com/matrix-org/matrix-spec/issues/1166))
|
|
|
|
|
- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
|
|
|
|
|
- Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions. ([#1179](https://github.com/matrix-org/matrix-spec/issues/1179))
|
|
|
|
|
- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
|
|
|
|
|
- Clarify that the "device_id", "user_id" and "access_token" fields are required in the response body of `POST /_matrix/client/v3/login`. ([#1210](https://github.com/matrix-org/matrix-spec/issues/1210))
|
|
|
|
|
- Reinforce the relationship of refreshed access tokens to transaction IDs. ([#1236](https://github.com/matrix-org/matrix-spec/issues/1236))
|
|
|
|
|
- Clarify enum values by separating possible values with commas. ([#1240](https://github.com/matrix-org/matrix-spec/issues/1240))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Server-Server API
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Backwards Compatible Changes</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add per-thread notifications and read receipts, as per [MSC3771](https://github.com/matrix-org/matrix-spec-proposals/pull/3771) and [MSC3773](https://github.com/matrix-org/matrix-spec-proposals/pull/3773). ([#1255](https://github.com/matrix-org/matrix-spec/issues/1255))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
|
|
|
|
|
- Tweak the styling of `<code>` snippets in tables rendered from OpenAPI definitions. ([#1179](https://github.com/matrix-org/matrix-spec/issues/1179))
|
|
|
|
|
- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Application Service API
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Breaking Changes</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Replace homeserver authorization approach with an `Authorization` header instead of `access_token` when talking to the application service, as per [MSC2832](https://github.com/matrix-org/matrix-spec-proposals/pull/2832). ([#1200](https://github.com/matrix-org/matrix-spec/issues/1200))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Identity Service API
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
|
|
|
|
|
- Update "API Standards" section to clarify how JSON is used. ([#1185](https://github.com/matrix-org/matrix-spec/issues/1185))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Push Gateway API
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add HTML anchors for object definitions in the formatted specification. ([#1174](https://github.com/matrix-org/matrix-spec/issues/1174))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Room Versions
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- For room versions 1 through 10, clarify that events with rejected `auth_events` must be rejected. ([#1137](https://github.com/matrix-org/matrix-spec/issues/1137))
|
|
|
|
|
- For room versions 2–10: correct a mistaken clarification to the state resolution algorithm. ([#1158](https://github.com/matrix-org/matrix-spec/issues/1158))
|
|
|
|
|
- For room versions 7 through 10: Clarify that `invite->knock` is actually a legal transition. ([#1175](https://github.com/matrix-org/matrix-spec/issues/1175))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Appendices
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
No significant changes.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Internal Changes/Tooling
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Backwards Compatible Changes</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Add internal changes changelog section. ([#1194](https://github.com/matrix-org/matrix-spec/issues/1194))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<strong>Spec Clarifications</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Render HTML anchors for object definition tables. ([#1191](https://github.com/matrix-org/matrix-spec/issues/1191))
|
|
|
|
|
- Give rendered-data sections a background and some padding. ([#1195](https://github.com/matrix-org/matrix-spec/issues/1195))
|
|
|
|
|
- Fix rendering of shortcodes within the client-server API. ([#1205](https://github.com/matrix-org/matrix-spec/issues/1205))
|
|
|
|
|
- Fix the spacing of mapping types generated from the OpenAPI spec. ([#1230](https://github.com/matrix-org/matrix-spec/issues/1230))
|