swagger: document /api/snapshots/pull

api/snapshot.go

@@ -483,7 +483,23 @@ func apiSnapshotsMerge(c *gin.Context) {
 	})
 }
 
-// POST /api/snapshots/pull
+// @Summary Snapshot Pull
+// @Description Create empty mirror with specified parameters.
+// @Tags Snapshots
+// @Param all-matches query int false "all-matches: 1 to enable"
+// @Param dry-run query int false "dry-run: 1 to enable"
+// @Param no-deps query int false "no-deps: 1 to enable"
+// @Param no-remove query int false "no-remove: 1 to enable"
+// @Accept  json
+// @Param Source body string true "source name where packages and dependencies will be searched"
+// @Param To body string true "snapshot where packages and dependencies will be pulled to"
+// @Param Destination body string true "name of the snapshot that will be created"
+// @Param Queries body []string true "list of package queries, in the simplest form, name of package to be pulled from"
+// @Param Architectures body []string true "list of architectures"
+// @Produce  json
+// @Success 200
+// @Failure 400 {object} Error "Bad Request"
+// @Router /api/snapshots/pull [post]
 func apiSnapshotsPull(c *gin.Context) {
 	var (
 		err                 error