postman-cli 1.45.0 → 1.46.1

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-07-30" "v1.45.0" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-08-12" "v1.46.1" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -264,7 +264,7 @@ Exports the cookie jar to a file after completing the run
 Show detailed information of collection run and each request sent
 .TP
 .B \-\-mock <path>
-Start a mock server from manifest (.json) file
+Start a mock server from manifest (.json, .yaml or .yml) file
 .TP
 .B \-\-simulate <path>
 Start mock servers with fault\-injection scenarios from a .sim.yaml file
@@ -276,6 +276,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
 
@@ -596,7 +666,7 @@ Specify an Id to a Postman Globals
 Number of virtual users (default: 20)
 .TP
 .B \-d, \-\-duration <minutes>
-Duration of the performance test in minutes (default: 10)
+Duration of the performance test in minutes (default: 1)
 .TP
 .B \-p, \-\-load\-profile <profile>
 Load profile type: fixed, ramp\-up, spike, peak (default: ramp\-up)
@@ -802,6 +872,15 @@ 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).
+.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: )
+.TP
 .B \-e, \-\-environment <path>
 Specify a path to a Postman Environment file (JSON or YAML)
 .TP
@@ -1292,7 +1371,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
@@ -1394,7 +1473,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)
@@ -1513,7 +1592,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)
@@ -1646,10 +1725,10 @@ Run and manage local Postman mock servers.
 .B Subcommands:
 .TP
 .B mock run
-Start a local mock server given a manifest file.
+Start a local mock server given a manifest file (JSON or YAML).
 
 .SS "mock run"
-Start a local mock server given a manifest file.
+Start a local mock server given a manifest file (JSON or YAML).
 
 .B Usage:
 <manifestPath>
@@ -1664,6 +1743,7 @@ Path to a globals file (JSON or YAML) for pm.globals
 
 .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
 
 
@@ -2070,7 +2150,7 @@ Quick start:
   postman search requests "auth"
   postman search requests "auth" \-\-filter "method=POST AND visibility=public" \-\-ownership org \-\-limit 10 \-\-output json
 
-Element types: requests, collections, workspaces, flows, specs, environments, mocks
+Element types: requests, collections, workspaces, flows, specs, environments, mocks, documents
 
 Detailed help is split by element type:
   postman search requests \-\-help      Request filters and examples
@@ -2080,6 +2160,7 @@ Detailed help is split by element type:
   postman search specs \-\-help         API spec filters and examples
   postman search mocks \-\-help         Mock filters and examples
   postman search environments \-\-help  Environment filters and examples
+  postman search documents \-\-help     Document filters and examples
 
 Pagination: \-\-limit accepts up to 25 results. Use \-\-cursor from the previous response to paginate.
 
@@ -2106,6 +2187,9 @@ Search for mocks by name or keyword.
 .TP
 .B search environments
 Search for environments by name or keyword.
+.TP
+.B search documents
+Search for documents by name or keyword.
 
 .SS "search requests"
 Search for requests by name or keyword.
@@ -2478,6 +2562,57 @@ Examples:
   postman search environments \-\-filter "environmentId=env\-abc123"
 
 
+.SS "search documents"
+Search for documents by name or keyword.
+
+.B Usage:
+[options] [query]
+
+.TP Examples:
+
+Use \-\-cursor from the previous response to paginate.
+Ownership:
+  organization, org  Search resources owned by your organization
+  external           Search resources outside your organization
+  all                Search both organization and external resources
+
+Output modes:
+  default            Card list including basic overview and web link per result
+  json               Detailed JSON response with search metadata
+
+Filter syntax:
+  Use = or != for single values: workspaceId=ws\-1
+  Use IN or NIN for comma\-separated values: workspaceId IN ws\-1,ws\-2
+  Combine filters with AND. Operators are case\-insensitive.
+  Quote supported values that contain spaces or commas: <field>="value with spaces"
+
+\-\-filter\-json format:
+  {"$and":[{"workspaceId":{"$eq":"ws\-abc123"}}]}
+  Only a top\-level $and array is supported; $or and nested groups are not supported.
+  Each condition maps one field to one operator object ($eq, $ne, $in, $nin).
+
+Shared filter fields:
+  privateNetwork      $eq, $ne  (true/false)
+  publisherIsVerified $eq, $ne  (true/false)
+  visibility          $eq, $ne  (internal, public, partner)
+  workspaceId         $eq, $ne, $in, $nin
+  createdBy           $eq, $ne, $in, $nin  (user ID)
+  organizationId      $eq, $ne, $in, $nin  (organization ID)
+  teamId              $eq, $ne, $in, $nin  (team ID)
+  isGitConnected      $eq, $ne  (true/false)
+
+Document filter fields:
+  documentId          $eq, $ne, $in, $nin
+
+ID filters such as createdBy, organizationId, teamId, workspaceId, and collectionId expect IDs.
+Use \-\-output json on a broader search result to inspect available IDs.
+
+Examples:
+  postman search documents "onboarding guide"
+  postman search documents "api reference" \-\-filter "workspaceId=ws\-abc123"
+  postman search documents \-\-filter "documentId=doc\-abc123"
+
+
 .SS "webhook"
 Create and manage Postman webhooks.
 

package/package.json

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