postman-cli 1.47.2 → 1.49.0

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-08-17" "v1.47.2" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-08-21" "v1.49.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -572,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
@@ -640,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.
 
@@ -683,14 +706,8 @@ Use a Postman Dataset as iteration data (with \-\-dataset\-view\-id)
 .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
+How rows map to VUs: round\-robin (default), fixed, 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)
@@ -890,14 +907,14 @@ Set flow inputs from JSON files (e.g. \-\-input\-file ./inputs.json \-\-input\-f
 .B \-s, \-\-scenario <name>
 Use a pre\-built scenario as flow inputs (by scenario name). Can be combined with \-\-input and \-\-input\-file to override values.
 .TP
-.B \-\-iteration\-data\-dataset <path>
-[BETA] Run the flow once per row of a local .dataset.yaml view. Requires \-\-iteration\-data\-view. Dataset columns feed the flow inputs (see \-\-map).
+.B \-\-iteration\-data\-dataset <pathOrId>
+[BETA] Run the flow once per row of a dataset view. Accepts a local .dataset.yaml path or a cloud dataset id (cloud requires login). Requires \-\-iteration\-data\-view. Dataset columns feed the flow inputs (see \-\-map\-column).
 .TP
 .B \-\-iteration\-data\-view <nameOrId>
 [BETA] Name or id of the view (within \-\-iteration\-data\-dataset) whose rows drive the run.
 .TP
-.B \-\-map <input=column>
-[BETA] Bind a flow input to a dataset column (e.g. \-\-map isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default: )
+.B \-m, \-\-map\-column <input=column>
+[BETA] Bind a flow input to a dataset column (e.g. \-m isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default: )
 .TP
 .B \-e, \-\-environment <path>
 Specify a path to a Postman Environment file (JSON or YAML)
@@ -905,6 +922,9 @@ Specify a path to a Postman Environment file (JSON or YAML)
 .B \-\-working\-dir <path>
 Specify the path to the working directory
 .TP
+.B \-\-no\-insecure\-file\-read
+Prevent reading dataset files situated outside of the working directory (applies to \-\-iteration\-data\-dataset)
+.TP
 .B \-\-verbose
 Show detailed information of flow run and each request (method, URL, assertions)
 .TP
@@ -942,6 +962,9 @@ Example:
   postman flows run ./path/to/flow.json \-\-output json
   postman flows run ./path/to/flow.json \-\-reporters html
   postman flows run ./path/to/flow.json \-\-workspace <workspaceId>
+  postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users"
+  postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users" \-\-map\-column isActive=active
+  postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users" \-i region=us\-east
 
 
 
@@ -1878,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
@@ -1921,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/
@@ -2702,6 +2729,9 @@ Show details for a webhook.
 .B webhook requests
 List, inspect, and replay requests received by a webhook.
 .TP
+.B webhook scripts
+Create or update scripts executed by a webhook.
+.TP
 .B webhook forward
 Forward incoming webhook requests to a local port.
 
@@ -2894,11 +2924,15 @@ Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.j
 .TP
 .B \-\-api\-key <key>
 Postman API key
+.TP
+.B \-\-verbose
+Show script execution logs
 
 .TP Examples:
 
 Examples:
   postman webhook requests describe 0123456789abcdefghijklmno 11111111\-1111\-4111\-8111\-111111111111
+  postman webhook requests describe 0123456789abcdefghijklmno 11111111\-1111\-4111\-8111\-111111111111 \-\-verbose
 
 
 
@@ -2923,6 +2957,42 @@ Examples:
 
 
 
+.SS "webhook scripts"
+Create or update scripts executed by a webhook.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B webhook scripts set
+Create or update a webhook script from a JavaScript or TypeScript file.
+
+.SS "webhook scripts set"
+Create or update a webhook script from a JavaScript or TypeScript file.
+
+.B Usage:
+[options] <webhookId> <scriptPath>
+
+.B Options:
+.TP
+.B \-\-event <event>
+Script event: onEvent or onResponse
+.TP
+.B \-w, \-\-workspace <workspaceId>
+Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)
+.TP
+.B \-\-api\-key <key>
+Postman API key
+
+.TP Examples:
+
+Examples:
+  postman webhook scripts set 0123456789abcdefghijklmno ./on\-event.js \-\-event onEvent
+  postman webhook scripts set 0123456789abcdefghijklmno ./on\-response.js \-\-event onResponse
+
+
+
 .SS "webhook forward"
 Forward incoming webhook requests to a local port.
 

package/package.json

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