postman-cli 1.67.0 → 1.68.0

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-09-29" "v1.67.0" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-10-01" "v1.68.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -305,6 +305,9 @@ Add, update, or remove requests in a local v3 collection.
 .B collection folder
 Add, update, or remove folders in a local v3 collection.
 .TP
+.B collection import
+Import a cURL or HAR source into a v3 collection (local, or cloud with \-\-workspace).
+.TP
 .B collection list
 List collections: your local project's collections by default, or a Postman cloud workspace's collections with \-\-workspace.
 .TP
@@ -787,6 +790,50 @@ Examples:
 
 
 
+.SS "collection import"
+Import a cURL or HAR source into a v3 collection (local, or cloud with \-\-workspace).
+
+.B Usage:
+[options] <src>
+
+.B Options:
+.TP
+.B \-\-type <format>
+Source format: curl or har. Auto\-detected from the extension/content when omitted.
+.TP
+.B \-\-name <name>
+Collection display name. Defaults to a per\-format fallback.
+.TP
+.B \-o, \-\-output <dir>
+Output directory for the local collection (default: postman/collections/<name>).
+.TP
+.B \-w, \-\-workspace <id>
+Create the collection in a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-force
+Overwrite an existing local target directory.
+.TP
+.B \-\-timeout <ms>
+Max time for a cloud import, in milliseconds (default 120000).
+.TP
+.B \-\-verbose
+Verbose output (cloud import diagnostics).
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+<src> is a file path, `\-` for stdin, or an inline cURL command.
+
+Examples:
+  postman collection import ./login.curl
+  postman collection import ./session.har \-\-name "Recorded session"
+  pbpaste | postman collection import \- \-\-type curl \-\-name Users
+  postman collection import ./session.har \-\-name Session \-\-workspace <workspaceId>
+
+
+
 .SS "collection list"
 List collections: your local project's collections by default, or a Postman cloud workspace's collections with \-\-workspace.
 
@@ -838,7 +885,7 @@ Specify an Id or path to a file containing Postman Globals
 Specify the reporters to use for the run: cli,json,junit,html. For multiple reporters, provide their names as a comma\-separated list (E.g., \-r cli,json) (default: cli)
 .TP
 .B    \-\-output <folder>
-Write a YAML\-based run report to the given folder. Creates a paired `<prefix>.collection\-run\-summary.yaml` (refreshed during the run) and streaming `<prefix>.collection\-run\-executions.yaml`, where prefix defaults to `<collection\-slug>\-<timestamp>`. Gotcha: \-\-output streams run data to file and cannot be combined with the built\-in reporters (\-r/\-\-reporter\-*); doing so exits with an error. This keeps large runs from buffering an entire report in memory.
+Write a YAML\-based run report to the given folder. Creates a paired `<prefix>.collection\-run\-summary.yaml` (refreshed during the run) and streaming `<prefix>.collection\-run\-executions.yaml`, where prefix defaults to `<collection\-slug>\-<timestamp>`. Gotcha: \-\-output streams run data to file, which keeps large runs from buffering an entire report in memory.
 .TP
 .B    \-\-reporter\-[reporter]\-export <path>
 [Optional] Specify a path to save the report. By default, reports are saved to the /postman\-cli\-reports directory in your current working directory. If the directory doesn't exist, it will be created automatically. If the specified path is an existing directory, the report file will be saved within it. Supported reporters: json, junit and html.
@@ -1781,7 +1828,7 @@ Invoke a monitor run and display results.
 Create a collection\-based monitor.
 .TP
 .B monitor update
-Update a monitor's schedule, runner, notifications or run options.
+Update a monitor's schedule, runner, notifications, request selection or run options.
 .TP
 .B monitor delete
 Permanently delete a monitor. Prompts for confirmation unless \-\-yes is passed.
@@ -1859,6 +1906,9 @@ Time zone for \-\-schedule, for example America/New_York (defaults to the host m
 .B \-\-runner <value>
 A Postman region name (see `postman runner regions`) or the id of a self\-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable) (default: )
 .TP
+.B \-i, \-\-item <id>
+Id of a request or folder in the collection to run, in the order given (repeatable; ids only, not names or paths; defaults to every request; list ids with `postman collection get <collection\-id> \-\-json`) (default: )
+.TP
 .B \-\-notify\-email <email>
 Email to notify on a run failure or error (repeatable) (default: )
 .TP
@@ -1913,12 +1963,13 @@ Examples:
   postman monitor create \-\-collection 12345678\-90ab\-cdef\-1234\-567890abcdef
   postman monitor create \-\-collection <id> \-\-schedule "0 9 * * MON" \-\-timezone America/New_York
   postman monitor create \-\-collection <id> \-\-runner us\-east \-\-runner <self\-hosted\-runner\-id>
+  postman monitor create \-\-collection <id> \-\-item <request\-id> \-\-item <folder\-id>
   postman monitor create \-\-collection <id> \-\-workspace 12345678\-90ab\-cdef\-1234\-567890abcdef
 
 
 
 .SS "monitor update"
-Update a monitor's schedule, runner, notifications or run options.
+Update a monitor's schedule, runner, notifications, request selection or run options.
 
 .B Usage:
 [options] <monitorId>
@@ -1937,6 +1988,12 @@ Time zone for \-\-schedule, for example America/New_York (defaults to the host m
 .B \-\-runner <value>
 A Postman region name (see `postman runner regions`) or the id of a self\-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable; replaces the current set) (default: )
 .TP
+.B \-i, \-\-item <id>
+Id of a request or folder in the collection to run, in the order given (repeatable; ids only, not names or paths; replaces the saved selection; list ids with `postman collection get <collection\-id> \-\-json`) (default: )
+.TP
+.B \-\-clear\-items
+Remove the saved selection so the monitor runs every request in its collection
+.TP
 .B \-\-notify\-email <email>
 Email to notify on a run failure or error (repeatable; replaces the current list) (default: )
 .TP
@@ -1998,6 +2055,8 @@ Examples:
   postman monitor update <id> \-\-notify\-email a@example.com \-\-notify\-email b@example.com
   postman monitor update <id> \-\-clear\-notifications
   postman monitor update <id> \-\-runner us\-east \-\-runner <self\-hosted\-runner\-id>
+  postman monitor update <id> \-\-item <request\-id> \-\-item <folder\-id>
+  postman monitor update <id> \-\-clear\-items
   postman monitor update <id> \-\-environment 12345678\-90ab\-cdef\-1234\-567890abcdef
 
 This command cannot change a monitor's linked collection \-\- that is fixed when the monitor is created, so run a different collection by creating a new monitor. It does not pause or resume a monitor either; use `monitor pause`/`monitor resume` for that.
@@ -2317,6 +2376,9 @@ Filter workspaces by name.
 .B \-t, \-\-type <type>
 Filter workspaces by visibility type: team, public, private, personal.
 .TP
+.B \-\-cursor <cursor>
+Fetch the page of workspaces that follows this cursor.
+.TP
 .B \-\-verbose
 Verbose output
 .TP
@@ -2333,6 +2395,7 @@ Examples:
   postman workspace list \-\-filter "my\-workspace"
   postman workspace list \-\-type team
   postman workspace list \-\-type team \-\-filter "project"
+  postman workspace list \-\-cursor "<cursor>"
 
 
 
@@ -2346,6 +2409,9 @@ Prepare local collections and environments for push by validating and regenerati
 .TP
 .B \-\-verbose
 Show detailed logging
+.TP
+.B \-\-json
+Print the outcome as machine\-readable JSON.
 
 .SS "workspace push"
 Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.
@@ -2364,6 +2430,9 @@ Skip all confirmation prompts
 .B \-\-push\-strategy <strategy>
 Push strategy. "force\-sync": mirror the whole workspace — also DELETE cloud entities that have no local counterpart (destructive). Defaults to "default" (create/update only).
 .TP
+.B \-\-json
+Print the outcome as machine\-readable JSON. Implies non\-interactive: use \-\-yes to actually push.
+.TP
 .B \-\-verbose
 Show detailed logging
 .TP
@@ -2455,6 +2524,9 @@ Create the workspace without binding it to the repository
 .TP
 .B \-\-force
 Create even when a workspace is already recorded for this repo
+.TP
+.B \-\-json
+Print the created workspace as machine\-readable JSON.
 
 .TP Examples:
 
@@ -2516,6 +2588,9 @@ Skip all confirmation prompts
 .B \-\-source\-workspace <workspaceId>
 Pull from a different source workspace.
 .TP
+.B \-\-json
+Print the outcome as machine\-readable JSON. Implies non\-interactive: use \-\-yes to actually pull.
+.TP
 .B \-\-verbose
 Show detailed logging
 
@@ -2542,6 +2617,9 @@ Connect a Postman workspace to a local git repository.
 .TP
 .B \-\-verbose
 Show detailed logging
+.TP
+.B \-\-json
+Print the outcome as machine\-readable JSON.
 
 .TP Examples:
 
@@ -2568,6 +2646,9 @@ Skip all confirmation prompts
 .TP
 .B \-\-verbose
 Show detailed logging
+.TP
+.B \-\-json
+Print the outcome as machine\-readable JSON. Requires \-\-yes to actually disconnect.
 
 .TP Examples:
 
@@ -3213,6 +3294,30 @@ Preserves the original HTTP method when following redirects. By default, redirec
 .B \-\-redirects\-remove\-referrer
 Removes the Referer header when following redirects. By default, Referer header is sent with redirects.
 .TP
+.B \-k, \-\-insecure
+Disable SSL certificate verification.
+.TP
+.B \-\-ssl\-client\-cert\-list <path>
+Specify the path to client certificate configurations (JSON).
+.TP
+.B \-\-ssl\-client\-cert <path>
+Specify the path to a client certificate (PEM).
+.TP
+.B \-\-ssl\-client\-key <path>
+Specify the path to a client certificate private key.
+.TP
+.B \-\-ssl\-client\-passphrase <passphrase>
+Specify the client certificate passphrase (for protected key).
+.TP
+.B \-\-ssl\-extra\-ca\-certs <path>
+Specify additional trusted CA certificates (PEM).
+.TP
+.B \-\-cookie\-jar <path>
+Specify the path to a custom cookie jar (serialized tough\-cookie JSON).
+.TP
+.B \-\-export\-cookie\-jar <path>
+Export the cookie jar to a file after completing the request.
+.TP
 .B \-\-retry <n>
 Number of retry attempts for failed requests (4xx, 5xx, network errors). Useful for flaky endpoints or rate\-limited APIs. (default: 0)
 .TP

package/package.json

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