diff --git a/docs/api/v1.24.md b/docs/api/v1.24.md
index 704ba8c011..af32fb5b3c 100644
--- a/docs/api/v1.24.md
+++ b/docs/api/v1.24.md
@@ -4823,7 +4823,7 @@ Return information on the service `id`.
 
 #### Update a service
 
-`POST /services/(id or name)/update`
+`POST /services/(id)/update`
 
 Update a service. When using this endpoint to create a service using a
 private repository from the registry, the `X-Registry-Auth` header can be used
diff --git a/docs/api/version-history.md b/docs/api/version-history.md
index 62f7430adc..b295eda91c 100644
--- a/docs/api/version-history.md
+++ b/docs/api/version-history.md
@@ -81,6 +81,7 @@ keywords: "API, Docker, rcli, REST, documentation"
 * `DELETE /secrets/{id}` removes the secret `id`.
 * `GET /secrets/{id}` returns information on the secret `id`.
 * `POST /secrets/{id}/update` updates the secret `id`.
+* `POST /services/(id or name)/update` now accepts service name or prefix of service id as a parameter.
 
 ## v1.24 API changes