diff --git a/api/application-service/query_room.yaml b/api/application-service/query_room.yaml
index 7a5a7e54..b885cb86 100644
--- a/api/application-service/query_room.yaml
+++ b/api/application-service/query_room.yaml
@@ -40,7 +40,7 @@ paths:
         - in: path
           name: roomAlias
           type: string
-          description: The URL encoded room alias being queried.
+          description: The room alias being queried.
           required: true
           x-example: "#magicforest:example.com"
       responses:
diff --git a/api/application-service/query_user.yaml b/api/application-service/query_user.yaml
index 4d1e9f44..0431b5e4 100644
--- a/api/application-service/query_user.yaml
+++ b/api/application-service/query_user.yaml
@@ -40,7 +40,7 @@ paths:
         - in: path
           name: userId
           type: string
-          description: The URL encoded user ID being queried.
+          description: The user ID being queried.
           required: true
           x-example: "@alice:example.com"
       responses: