diff --git a/docs/api/v1.24.md b/docs/api/v1.24.md
index b86a102dc8..a1de53bed2 100644
--- a/docs/api/v1.24.md
+++ b/docs/api/v1.24.md
@@ -4835,7 +4835,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 4363cfbd74..a9cd07c1f1 100644
--- a/docs/api/version-history.md
+++ b/docs/api/version-history.md
@@ -83,6 +83,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