postman-cli 1.46.0 → 1.47.2

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-08-11" "v1.46.0" "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
@@ -276,6 +279,76 @@ Send run results and analytics to Postman
 Eg. postman collection run 123456\-45159473\-1e45\-1f34\-5678\-1234567890ab
 
 
+.SS "environment"
+Work with local Postman environments from the command line.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B environment lint
+Run linting on a local Postman environment at the given file or directory path.
+
+.SS "environment lint"
+Run linting on a local Postman environment at the given file or directory path.
+
+.B Usage:
+<path> [options]
+
+.B Options:
+.TP
+.B \-f, \-\-fail\-severity <value>
+Exit with failure if diagnostics at this level or above are present. [choices: "error", "warning"] (default: error)
+.TP
+.B \-o, \-\-output <value>
+Output format: cli (human\-readable), table, json, or csv. (default: cli)
+
+.TP Examples:
+
+Examples:
+  $ postman environment lint ./postman/environments
+  $ postman environment lint ./dev.environment.yaml
+  $ postman environment lint ./postman/environments \-\-output json
+  $ postman environment lint ./dev.environment.yaml \-\-fail\-severity warning
+
+
+
+.SS "globals"
+Work with local Postman globals from the command line.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B globals lint
+Run linting on a local Postman globals file at the given file or directory path.
+
+.SS "globals lint"
+Run linting on a local Postman globals file at the given file or directory path.
+
+.B Usage:
+<path> [options]
+
+.B Options:
+.TP
+.B \-f, \-\-fail\-severity <value>
+Exit with failure if diagnostics at this level or above are present. [choices: "error", "warning"] (default: error)
+.TP
+.B \-o, \-\-output <value>
+Output format: cli (human\-readable), table, json, or csv. (default: cli)
+
+.TP Examples:
+
+Examples:
+  $ postman globals lint ./postman/globals
+  $ postman globals lint ./workspace.globals.yaml
+  $ postman globals lint ./postman/globals \-\-output json
+  $ postman globals lint ./workspace.globals.yaml \-\-fail\-severity warning
+
+
+
 .SS "api"
 Publish and test your APIs directly from the command line
 
@@ -604,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
@@ -1301,7 +1389,7 @@ Generate a new SDK from a Postman collection or specification (OpenAPI or AsyncA
 .B Options:
 .TP
 .B \-l, \-\-language <languages...>
-Target language(s) for SDK generation. Specify one or more languages. [choices: "typescript", "python", "java", "go", "csharp", "php", "ruby", "cli", "kotlin", "rust"]
+Target language(s) for SDK generation. Specify one or more languages. [choices: "typescript", "python", "java", "go", "csharp", "php", "ruby", "cli", "kotlin", "rust", "swift"]
 .TP
 .B \-\-all
 Generate SDKs for all supported languages
@@ -1403,7 +1491,7 @@ Enable change tracking for a generated SDK. Adds file hashes to .manifest.json s
 .B Options:
 .TP
 .B \-l, \-\-language <languages...>
-Language(s) to track. [choices: "typescript", "python", "java", "go", "csharp", "php", "ruby", "cli", "kotlin", "rust"]
+Language(s) to track. [choices: "typescript", "python", "java", "go", "csharp", "php", "ruby", "cli", "kotlin", "rust", "swift"]
 .TP
 .B \-o, \-\-output\-dir <path>
 Base directory containing generated SDKs (default: ./sdks)
@@ -1522,7 +1610,7 @@ Connect a collection or specification to a GitHub repository for automatic SDK p
 .B Options:
 .TP
 .B \-l, \-\-language <language>
-SDK language (required) [choices: typescript, python, java, go, csharp, php, ruby, cli, kotlin, rust]
+SDK language (required) [choices: typescript, python, java, go, csharp, php, ruby, cli, kotlin, rust, swift]
 .TP
 .B \-r, \-\-repo <owner/name>
 GitHub repository in <owner>/<name> form (alternative to \-\-repo\-owner + \-\-repo\-name)
@@ -1654,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).
 
@@ -1670,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.0",
+  "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.0",
-    "@postman/pm-bin-macos-x64": "1.46.0",
-    "@postman/pm-bin-linux-x64": "1.46.0",
-    "@postman/pm-bin-linux-arm64": "1.46.0",
-    "@postman/pm-bin-windows-x64": "1.46.0"
+    "@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"
   }
 }