diff --git a/api/swagger.yaml b/api/swagger.yaml
index 7b48c0f798..39e81ee97f 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -6230,6 +6230,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 c73e772975..d151c6e11f 100644
--- a/docs/api/version-history.md
+++ b/docs/api/version-history.md
@@ -230,6 +230,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