diff --git a/developer-guides/rest-api/README.md b/developer-guides/rest-api/README.md
index 754f94f34e..7bc8617d0f 100644
--- a/developer-guides/rest-api/README.md
+++ b/developer-guides/rest-api/README.md
@@ -21,7 +21,7 @@ When calling a production Rocket.Chat server, ensure it is running via HTTPS and
 | Url                       | Short Description                                         | Details Page                           |
 | :------------------------ | :-------------------------------------------------------- | :------------------------------------- |
 | `/api/info`               | Information about the Rocket.Chat server.                 | [Link](miscellaneous/info/)            |
-| `/api/v1/directory`       | Search by users or channels on all server.                | [Link](miscellaneous/directory/)       |
+| `/api/v1/directory`       | Search by all users and channels available on server.     | [Link](miscellaneous/directory/)       |
 | `/api/v1/shield.svg`      | Gets the shield svg(badge) to add in your website.        | [Link](miscellaneous/shield-svg/)      |
 | `/api/v1/spotlight`       | Searches for users or rooms that are visible to the user. | [Link](miscellaneous/spotlight/)       |
 | `/api/v1/statistics`      | Statistics about the Rocket.Chat server.                  | [Link](miscellaneous/statistics/)      |
diff --git a/developer-guides/rest-api/miscellaneous/README.md b/developer-guides/rest-api/miscellaneous/README.md
index 7c8be76ae2..2fd876dab6 100644
--- a/developer-guides/rest-api/miscellaneous/README.md
+++ b/developer-guides/rest-api/miscellaneous/README.md
@@ -4,7 +4,7 @@ Just some generic information, such as information about the server and authenti
 
 | Url | Short Description | Details Page |
 | :--- | :--- | :--- |
-| `/api/v1/directory` | Search by users or channels on all server. | [Link](directory/) |
+| `/api/v1/directory` | Search by all users and channels available on server. | [Link](directory/) |
 | `/api/info` | Information about the Rocket.Chat server. | [Link](info/) |
 | `/api/v1/shield.svg` | Gets the shield svg(badge) to add in your website. | [Link](shield-svg/) |
 | `/api/v1/spotlight` | Searches for users or rooms that are visible to the user. | [Link](spotlight/) |