postman-cli 1.46.1 → 1.47.2

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-08-12" "v1.46.1" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-08-17" "v1.47.2" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -266,6 +266,9 @@ Show detailed information of collection run and each request sent
 .B \-\-mock <path>
 Start a mock server from manifest (.json, .yaml or .yml) file
 .TP
+.B \-\-port <port>
+Port for the \-\-mock server; pass "auto" for an OS\-assigned ephemeral port (default: configured port, falls back to an ephemeral one if busy). Only valid with \-\-mock.
+.TP
 .B \-\-simulate <path>
 Start mock servers with fault\-injection scenarios from a .sim.yaml file
 .TP
@@ -674,6 +677,21 @@ Load profile type: fixed, ramp\-up, spike, peak (default: ramp\-up)
 .B \-\-data\-file <path>
 Path to a JSON or CSV data file to use with the collection
 .TP
+.B \-\-dataset\-id <id>
+Use a Postman Dataset as iteration data (with \-\-dataset\-view\-id)
+.TP
+.B \-\-dataset\-view\-id <id>
+Dataset view to execute for iteration data (requires \-\-dataset\-id)
+.TP
+.B \-\-dataset\-offset <offset>
+Row offset into the view result (optional range)
+.TP
+.B \-\-dataset\-limit <limit>
+Max rows to fetch from the view (optional range)
+.TP
+.B \-\-dataset\-distribution <strategy>
+How rows map to VUs: round\-robin (default), pinned, random
+.TP
 .B \-\-postman\-api\-key <apiKey>
 API Key used to load the resources from the Postman API (Only supported in the US region, use 'postman login \-\-region' to authenticate instead)
 .TP
@@ -1724,9 +1742,46 @@ Run and manage local Postman mock servers.
 
 .B Subcommands:
 .TP
+.B mock generate
+Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git\-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto\-detected.
+.TP
 .B mock run
 Start a local mock server given a manifest file (JSON or YAML).
 
+.SS "mock generate"
+Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git\-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto\-detected.
+
+.B Usage:
+<sourcePath> [options]
+
+.B Options:
+.TP
+.B \-o, \-\-output <dir>
+Output directory for the mock (default: postman/mocks/<slug>)
+.TP
+.B \-\-name <name>
+Display name for the generated mock
+.TP
+.B \-\-port <port>
+Port the mock server should listen on (default: 4500)
+.TP
+.B \-\-force
+Overwrite the config.yaml/default.js in the output directory if it already exists
+.TP
+.B \-u, \-\-update <mockPath>
+Update an existing mock in place from the source: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port/scenarios. Cannot be combined with \-\-output.
+.TP
+.B \-x, \-\-suppress\-exit\-code
+Always exit with code 0, even on failure
+
+.TP Examples:
+
+Eg. postman mock generate ./my\-collection.json
+    postman mock generate "./postman/collections/My Collection" \-\-port 4010
+    postman mock generate ./openapi.yaml \-\-output ./postman/mocks/api \-\-port 4010
+    postman mock generate ./my\-collection.json \-\-update ./postman/mocks/orders
+
+
 .SS "mock run"
 Start a local mock server given a manifest file (JSON or YAML).
 
@@ -1740,11 +1795,16 @@ Path to an environment file (JSON or YAML) for pm.environment
 .TP
 .B \-g, \-\-globals <path>
 Path to a globals file (JSON or YAML) for pm.globals
+.TP
+.B \-p, \-\-port <port>
+Mock server port, or "auto" for an ephemeral one (default: configured port, falls back to an ephemeral one if busy).
 
 .TP Examples:
 Eg. postman mock run ./postman/mock\-manifest.json
     postman mock run ./postman/mock\-manifest.yaml
     postman mock run ./manifest.json \-\-environment ./postman/environments/dev.yaml
+    postman mock run ./manifest.yaml \-\-port auto        # OS\-assigned ephemeral port
+    postman mock run ./manifest.yaml \-\-port 4600        # exact port, errors if busy
 
 
 .SS "application"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli",
-  "version": "1.46.1",
+  "version": "1.47.2",
   "description": "Official Postman CLI - Command-line companion for API development, testing, and automation",
   "keywords": [
     "postman",
@@ -58,10 +58,10 @@
     "man/"
   ],
   "optionalDependencies": {
-    "@postman/pm-bin-macos-arm64": "1.46.1",
-    "@postman/pm-bin-macos-x64": "1.46.1",
-    "@postman/pm-bin-linux-x64": "1.46.1",
-    "@postman/pm-bin-linux-arm64": "1.46.1",
-    "@postman/pm-bin-windows-x64": "1.46.1"
+    "@postman/pm-bin-macos-arm64": "1.47.2",
+    "@postman/pm-bin-macos-x64": "1.47.2",
+    "@postman/pm-bin-linux-x64": "1.47.2",
+    "@postman/pm-bin-linux-arm64": "1.47.2",
+    "@postman/pm-bin-windows-x64": "1.47.2"
   }
 }