postman-cli 1.46.1 → 1.48.0

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-19" "v1.48.0" "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
@@ -569,6 +572,9 @@ Prepare local collections and environments for push by validating and regenerati
 .TP
 .B workspace push
 Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.
+.TP
+.B workspace lint
+Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use \-\-meta to lint only the configuration.
 
 .SS "workspace list"
 List all available Postman Workspaces
@@ -637,6 +643,26 @@ Show detailed logging
 .B \-\-report\-events
 Send workspace push events to Postman
 
+.SS "workspace lint"
+Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use \-\-meta to lint only the configuration.
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-f, \-\-fail\-severity <value>
+Exit with failure if diagnostics at this level or above are present. [choices: "error", "warning", "info", "hint"] (default: error)
+.TP
+.B \-o, \-\-output <value>
+Output format: cli (human\-readable), table, or json. (default: cli)
+.TP
+.B \-\-meta
+Only lint the workspace configuration (.postman/resources.yaml); skip per\-entity linting.
+.TP
+.B \-\-workspace\-id <value>
+The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.
+
 .SS "performance"
 Manage performance tests on your collections.
 
@@ -674,6 +700,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 +1765,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 +1818,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"
@@ -1818,6 +1901,9 @@ Environment override for the selected target (last value wins) (default: )
 .B \-\-command <cmd>
 Command to run first (primary task). Overrides config.
 .TP
+.B \-\-deployed\-version <version>
+Version identity of the application under test (e.g. a build ID, release tag, or version string). Also read from the APP_DEPLOYED_VERSION environment variable.
+.TP
 .B \-\-network\-log <path>
 Directory to scan for captured artifacts, or a direct path to a Playwright JSON report / NDJSON capture file. When a directory is given, recursively discovers `*.json` Playwright reports plus their `trace.zip` attachments, and `network\-capture\-*.ndjson` at the top level. By default, scans Playwright config `outputDir`, test\-results/, then pm\-results/.
 .TP
@@ -1861,6 +1947,7 @@ Use \-\-report\-events to send run results to Postman. Analytics are also sent a
 Examples:
   postman application test \-\-command "npx playwright test"
   postman application test \-\-target prod
+  postman application test \-\-command "npx playwright test" \-\-deployed\-version $BUILD_ID
   postman application test \-\-target beta \-\-target\-collection api.json \-\-target\-environment staging.json
   postman app test \-\-capture\-only \-\-command "npx playwright test"
   postman app test \-\-capture\-only \-\-output ./my\-captured\-traffic/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli",
-  "version": "1.46.1",
+  "version": "1.48.0",
   "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.48.0",
+    "@postman/pm-bin-macos-x64": "1.48.0",
+    "@postman/pm-bin-linux-x64": "1.48.0",
+    "@postman/pm-bin-linux-arm64": "1.48.0",
+    "@postman/pm-bin-windows-x64": "1.48.0"
   }
 }