Skip to content

Commit 85e0444

Browse files
authored
Misc clarifications to threading MSCs (#3899)
* Thread bundles exclude ignored users Per implementation: matrix-org/synapse#12235 * Clarify that the threads list API returns a 403 too Per implementation: matrix-org/synapse#13394 * Reference a token that actually exists
1 parent aa51353 commit 85e0444

File tree

3 files changed

+10
-4
lines changed

3 files changed

+10
-4
lines changed

proposals/3440-threading-via-relations.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,14 @@ would include additional information in the `unsigned` field:
5151
}
5252
```
5353

54-
* `latest_event`: The most recent event which relates to this event, with
55-
`rel_type` of `m.thread`.
54+
* `latest_event`: The most recent event (topologically) which relates to this event, with
55+
`rel_type` of `m.thread`. Events sent by [ignored users](https://spec.matrix.org/v1.3/client-server-api/#ignoring-users)
56+
are not considered for the latest event.
5657

5758
The latest event should be serialised in the same form as the event itself;
5859
this includes adding any bundled aggregations for the event (and applying edits).[^1]
59-
* `count`: An integer counting the number of `m.thread` events
60+
* `count`: An integer counting the number of `m.thread` events, excluding events sent
61+
by [ignored users](https://spec.matrix.org/v1.3/client-server-api/#ignoring-users).
6062
* `current_user_participated`: A boolean flag, which is set to `true` if the
6163
current logged in user has participated in the thread. The user has participated if:
6264
* They created the current event.

proposals/3715-relations-parity-messages.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ previous calls (as well as `next_batch` values, as is currently specified). The
7575
[definition of the `from` parameter](https://spec.matrix.org/unstable/client-server-api/#get_matrixclientv1roomsroomidrelationseventid)
7676
is updated:
7777

78-
> Can be a `from_batch` token **or `next_batch`** token from a previous call, or a
78+
> Can be a `next_batch` token **or `prev_batch`** token from a previous call, or a
7979
> returned `start` token from `/messages`, or a `next_batch` token from `/sync`.
8080
8181
(Bold indicates new text.)

proposals/3856-threads-list-api.md

+4
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,10 @@ slightly. This has two situations:
113113
non-ignored user; with the caveat that the ordering of the threads is not
114114
re-arranged due to this replacement.
115115

116+
Like [`/messages`](https://spec.matrix.org/v1.3/client-server-api/#get_matrixclientv3roomsroomidmessages),
117+
this returns a 403 `M_FORBIDDEN` error response if the caller isn't able to see the
118+
room's history.
119+
116120
#### Example request:
117121

118122
```

0 commit comments

Comments
 (0)