diff --git a/docs/api/supervisor/endpoints.md b/docs/api/supervisor/endpoints.md
index ac0a8519..f7e84cc7 100644
--- a/docs/api/supervisor/endpoints.md
+++ b/docs/api/supervisor/endpoints.md
@@ -2057,8 +2057,15 @@ Returns information about available updates
 
 </ApiEndpoint>
 
+<ApiEndpoint path="/reload_updates" method="post">
+This reloads information about main components (OS, Supervisor, Core, and
+Plug-ins).
+</ApiEndpoint>
+
 <ApiEndpoint path="/refresh_updates" method="post">
 This reloads information about add-on repositories and fetches new version files.
+This endpoint is currently discouraged. Use `/reload_updates` or `/store/reload`
+instead.
 </ApiEndpoint>
 
 <ApiEndpoint path="/info" method="get">