diff --git a/api/swagger.yaml b/api/swagger.yaml
index 610dc778d8..bd961e4a03 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -10002,7 +10002,12 @@ paths:
   /images/{name}/tag:
     post:
       summary: "Tag an image"
-      description: "Tag an image so that it becomes part of a repository."
+      description: |
+        Create a tag that refers to a source image.
+
+        This creates an additional reference (tag) to the source image. The tag
+        can include a different repository name and/or tag. If the repository
+        or tag already exists, it will be overwritten.
       operationId: "ImageTag"
       responses:
         201: