diff --git a/api/client-server/directory.yaml b/api/client-server/directory.yaml
index 7a2a2378..0a69a8ec 100644
--- a/api/client-server/directory.yaml
+++ b/api/client-server/directory.yaml
@@ -98,10 +98,10 @@ paths:
                 description: The room ID for this room alias.
               servers:
                 type: array
-                description: A list of servers that are aware of this room ID.
+                description: A list of servers that are aware of this room alias.
                 items:
                   type: string
-                  description: A server which is aware of this room ID.
+                  description: A server which is aware of this room alias.
           examples:
             application/json: |-
               {
@@ -118,7 +118,7 @@ paths:
             application/json: |-
               {
                 "errcode": "M_NOT_FOUND",
-                "error": "Room ID !abnjk1jdasj98:capuchins.com not found."
+                "error": "Room alias #monkeys:matrix.org not found."
               }
       tags:
         - Room directory