summary refs log tree commit diff
path: root/docs/client-server
diff options
context:
space:
mode:
authorPaul "LeoNerd" Evans <paul@matrix.org>2014-08-15 17:24:02 +0100
committerPaul "LeoNerd" Evans <paul@matrix.org>2014-08-15 17:24:02 +0100
commit1731781145bde39dedd443e4ca748041e83110bc (patch)
tree73056da0a2e4f51bb1a405f11ccdcc284d45be62 /docs/client-server
parentWhen starting to poll for presence, also include members of all shared rooms (diff)
downloadsynapse-1731781145bde39dedd443e4ca748041e83110bc.tar.xz
Document that /rooms/:room_id/members/list yields profile and presence information about room members
Diffstat (limited to 'docs/client-server')
-rw-r--r--docs/client-server/specification.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/client-server/specification.rst b/docs/client-server/specification.rst
index 3367884ad4..4c1a3d4456 100644
--- a/docs/client-server/specification.rst
+++ b/docs/client-server/specification.rst
@@ -694,6 +694,16 @@ Invite/Joining/Leaving a room
   Required keys:
     membership : [join|invite] - The membership state of $user_id in room 
                                  $room_id.
+  Optional keys:
+    displayname,
+    avatar_url : String fields from the member user's profile
+    state,
+    status_msg,
+    mtime_age : Presence information
+
+  These optional keys provide extra information that the client is likely to
+  be interested in so it doesn't have to perform an additional profile or
+  presence information fetch.
 
 Where:
   join - Indicate you ($user_id) are joining the room $room_id.