Skip to content

Commit 0279975

Browse files
authored
Clarify the meaning of a read_events action without a state_key (#4288)
Currently MSC2762 is ambiguous as to whether the absence of a state_key in a read_events action means that both state events and message-like events should be returned, or just message-like events. We should clarify this behavior, and I for one find it difficult to imagine a real use case that would benefit from the ability to read both state events and message-like events of a single event type as part of the same request, so I propose we limit the response to just message-like events in this case. This aligns the behavior with what Element Web did prior to the introduction of the update_state action.
1 parent 1f32d05 commit 0279975

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

proposals/2762-widget-event-receiving.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -285,6 +285,9 @@ API action:
285285
}
286286
```
287287

288+
When no `state_key` is present, the client will respond with message-like events (i.e. non-state
289+
events) matching the event type.
290+
288291
When a `state_key` is present, the client will respond with state events matching that state key. If
289292
`state_key` is instead a boolean `true`, the client will respond with state events of the given type
290293
with any state key.

0 commit comments

Comments
 (0)