diff --git a/api/swagger.yaml b/api/swagger.yaml
index 4fe0791b24..6e0bc25b52 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -6217,6 +6217,10 @@ paths:
           in: "query"
           description: "If “1”, “true”, or “True” then it will be an error if unpacking the given content would cause an existing directory to be replaced with a non-directory and vice versa."
           type: "string"
+        - name: "copyUIDGID"
+          in: "query"
+          description: "If “1”, “true”, then it will copy UID/GID maps to the dest file or dir"
+          type: "string"
         - name: "inputStream"
           in: "body"
           required: true
diff --git a/docs/api/version-history.md b/docs/api/version-history.md
index 30f2bb4b67..c8327ddf84 100644
--- a/docs/api/version-history.md
+++ b/docs/api/version-history.md
@@ -220,6 +220,7 @@ keywords: "API, Docker, rcli, REST, documentation"
 * `GET /events` now supports service, node and secret events which are emitted when users create, update and remove service, node and secret
 * `GET /events` now supports network remove event which is emitted when users remove a swarm scoped network
 * `GET /events` now supports a filter type `scope` in which supported value could be swarm and local
+* `PUT /containers/(name)/archive` now accepts a `copyUIDGID` parameter to allow copy UID/GID maps to dest file or dir.
 
 ## v1.29 API changes