From 116253b2f5722c0b42e70d406e4564886afc69eb Mon Sep 17 00:00:00 2001 From: "Paul \"LeoNerd\" Evans" Date: Thu, 17 Dec 2015 20:45:57 +0000 Subject: [PATCH] Document the /event/:event_id/ federation endpoint --- specification/server_server_api.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/specification/server_server_api.rst b/specification/server_server_api.rst index 97f446a4..2365505e 100644 --- a/specification/server_server_api.rst +++ b/specification/server_server_api.rst @@ -503,6 +503,17 @@ Retrieves a snapshot of the entire current state of the given room. The response will contain a single Transaction, inside which will be a list of PDUs that encode the state. + +To fetch a particular event:: + + GET .../event// + Response: JSON encoding of a partial Transaction containing the event + +Retrieves a single event. The response will contain a partial Transaction, +having just the ``origin``, ``origin_server_ts`` and ``pdus`` fields; the +event will be encoded as the only PDU in the ``pdus`` list. + + To backfill events on a given room:: GET .../backfill//