diff --git a/specification/modules/guest_access.rst b/specification/modules/guest_access.rst index cd43524b..b6676121 100644 --- a/specification/modules/guest_access.rst +++ b/specification/modules/guest_access.rst @@ -33,21 +33,16 @@ retrieving events: * `GET /rooms/:room_id/state/:event_type/:state_key <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-state-eventtype-statekey>`_ * `GET /rooms/:room_id/messages <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-messages>`_ * `GET /rooms/:room_id/initialSync <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-initialsync>`_ +* `GET /rooms/:room_id/sync <#get-matrix-client-%CLIENT_MAJOR_VERSION%-sync>`_ -There is also a special version of the -`GET /events <#get-matrix-client-%CLIENT_MAJOR_VERSION%-events>`_ endpoint: - -{{guest_events_http_api}} - -They will only return events which happened while the room state had the -``m.room.history_visibility`` state event present with ``history_visibility`` -value ``world_readable``. Guest clients do not need to join rooms in order to -receive events for them. +Note that the ``/sync`` API requires an inline filter to be specified which lists +the desired room IDs. The following API endpoints are allowed to be accessed by guest accounts for sending events: * `POST /rooms/:room_id/join <#post-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-join>`_ +* `POST /rooms/:room_id/leave <#post-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-leave>`_ * `PUT /rooms/:room_id/send/m.room.message/:txn_id <#put-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-send-eventtype-txnid>`_ Guest clients *do* need to join rooms in order to send events to them. @@ -57,6 +52,16 @@ their own account maintenance: * `PUT /profile/:user_id/displayname <#put-matrix-client-%CLIENT_MAJOR_VERSION%-profile-userid-displayname>`_ +There is also a special version of the +`GET /events <#get-matrix-client-%CLIENT_MAJOR_VERSION%-events>`_ endpoint: + +{{guest_events_http_api}} + +They will only return events which happened while the room state had the +``m.room.history_visibility`` state event present with ``history_visibility`` +value ``world_readable``. Guest clients do not need to join rooms in order to +receive events for them. + Server behaviour ---------------- Servers are required to only return events to guest accounts for rooms where