diff --git a/docs/specification.rst b/docs/specification.rst
index b679c8cb6ed61132eae3b343c3581339d660a2fc..1b844b963fd9fbc35846b82ebeb47f138db8db24 100644
--- a/docs/specification.rst
+++ b/docs/specification.rst
@@ -317,9 +317,11 @@ Modifying aliases
   This section is a work in progress.
 
 .. TODO kegan
-    - path to edit aliases
+    - path to edit aliases 
+    - PUT /directory/room/<room alias>  { room_id : foo }
+    - GET /directory/room/<room alias> { room_id : foo, servers: [a.com, b.com] }
     - format when retrieving list of aliases. NOT complete list.
-    - format for adding aliases.
+    - format for adding/removing aliases.
 
 Permissions
 -----------