postman-cli 1.67.0 → 1.69.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.69.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -300,10 +300,16 @@ Generate artifacts from a collection.
 Sync artifacts generated from a collection.
 .TP
 .B collection request
-Add, update, or remove requests in a local v3 collection.
+Add, get, update, or remove requests in a local v3 collection.
 .TP
 .B collection folder
-Add, update, or remove folders in a local v3 collection.
+Add, get, update, or remove folders in a local v3 collection.
+.TP
+.B collection example
+Add, update, remove, get, or list examples (saved responses) under a request.
+.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.
@@ -507,7 +513,7 @@ Examples:
 
 
 .SS "collection request"
-Add, update, or remove requests in a local v3 collection.
+Add, get, update, or remove requests in a local v3 collection.
 
 .B Usage:
 [options] [command]
@@ -517,6 +523,9 @@ Add, update, or remove requests in a local v3 collection.
 .B collection request add
 Add an empty request to a local v3 collection (set its details later with `update`).
 .TP
+.B collection request get
+Show a request (any type) in a v3 collection: its own fields, with examples and messages as references.
+.TP
 .B collection request update
 Update a request in a v3 collection (only the fields you pass).
 .TP
@@ -557,6 +566,38 @@ Examples:
 
 
 
+.SS "collection request get"
+Show a request (any type) in a v3 collection: its own fields, with examples and messages as references.
+
+.B Usage:
+[options] <request>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path. Required locally; optional in cloud mode (id only).
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope a bare\-name request selector, e.g. "Users/Admin" (local mode only).
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+Prints the request's own fields in the V3 collection format. Its examples (and, for WebSocket / Socket.IO / MQTT, its messages) are listed as references ({ id, $kind } in cloud mode; { name, $kind } plus id when stored, locally). "parent" is added: the containing folder, or the collection for a top\-level request. A linked copy of a reusable request carries "uses" (its source request id) and a source carries "usedBy" (its linked copies); the source may live in another collection, so fetch it by id alone. Select the request by the <request> selector: local — a name or "Folder/Name" path (or \-\-folder to scope a bare name); cloud (\-\-workspace) — a request id, with \-\-collection (an id) optional and no \-\-folder. Read\-only: locally it reads v3 collections only and rejects a v2.1 .json instead of converting it.
+
+Examples:
+  postman collection request get "Get user" \-\-collection "My API"
+  postman collection request get "Users/Get user" \-\-collection "My API" \-\-json
+  postman collection request get <requestId> \-w <workspaceId>
+  postman collection request get <requestId> \-\-collection <collectionId> \-w <workspaceId> \-\-json
+
+
+
 .SS "collection request update"
 Update a request in a v3 collection (only the fields you pass).
 
@@ -662,7 +703,7 @@ Examples:
 
 
 .SS "collection folder"
-Add, update, or remove folders in a local v3 collection.
+Add, get, update, or remove folders in a local v3 collection.
 
 .B Usage:
 [options] [command]
@@ -672,6 +713,9 @@ Add, update, or remove folders in a local v3 collection.
 .B collection folder add
 Add an empty folder to a local v3 collection (set its details later with `update`).
 .TP
+.B collection folder get
+Show a folder in a v3 collection: its own fields and its direct children as references.
+.TP
 .B collection folder update
 Update a folder in a v3 collection (only the fields you pass).
 .TP
@@ -709,6 +753,38 @@ Examples:
 
 
 
+.SS "collection folder get"
+Show a folder in a v3 collection: its own fields and its direct children as references.
+
+.B Usage:
+[options] <folder>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path. Required locally; optional in cloud mode (id only).
+.TP
+.B \-\-folder <id|name|path>
+Parent folder to scope a bare\-name selector, e.g. "Users" (local mode only).
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+Prints the folder's own fields in the V3 collection format. Its direct children (requests and sub\-folders) are listed under "items" as references ({ id, $kind } in cloud mode; { name, $kind } plus id when stored, locally) — run `get` on a child to go further. "parent" is added: the containing folder, or the collection for a top\-level folder. Select the folder by the <folder> selector: local — a name or "Parent/Name" path (or \-\-folder to scope a bare name); cloud (\-\-workspace) — a folder id, with \-\-collection (an id) optional and no \-\-folder. Read\-only: locally it reads v3 collections only and rejects a v2.1 .json instead of converting it.
+
+Examples:
+  postman collection folder get Users \-\-collection "My API"
+  postman collection folder get "Users/Admin" \-\-collection "My API" \-\-json
+  postman collection folder get <folderId> \-w <workspaceId>
+  postman collection folder get <folderId> \-\-collection <collectionId> \-w <workspaceId> \-\-json
+
+
+
 .SS "collection folder update"
 Update a folder in a v3 collection (only the fields you pass).
 
@@ -787,6 +863,253 @@ Examples:
 
 
 
+.SS "collection example"
+Add, update, remove, get, or list examples (saved responses) under a request.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B collection example add
+Add an empty example under a request (defaults to 200 OK; set details later with `update`).
+.TP
+.B collection example update
+Update an example (only the fields you pass).
+.TP
+.B collection example rm
+Remove an example from a request.
+.TP
+.B collection example get
+Get a single example.
+.TP
+.B collection example list
+List examples under a request.
+
+.SS "collection example add"
+Add an empty example under a request (defaults to 200 OK; set details later with `update`).
+
+.B Usage:
+[options] [example\-name]
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path. Required.
+.TP
+.B \-\-request <id|name|path>
+Parent request (required). Local: name/path/id; cloud: id.
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector, e.g. "Users/Admin".
+.TP
+.B \-\-type <type>
+Example type: http (default). (default: http)
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+Creates a stub example (name + type + default 200/OK/{} response). Configure it with `collection example update`. \-\-request is required.
+
+Examples:
+  postman collection example add "Success" \-\-collection "My API" \-\-request "Get user"
+  postman collection example add \-\-collection "My API" \-\-request Ping
+  postman collection example add "Ok" \-\-collection <cid> \-\-request <rid> \-w <workspaceId>
+
+
+
+.SS "collection example update"
+Update an example (only the fields you pass).
+
+.B Usage:
+[options] <example>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection. Required.
+.TP
+.B \-\-request <id|name|path>
+Parent request (optional; disambiguates local names / \-\-copy\-request).
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector.
+.TP
+.B \-\-status\-code <code>
+HTTP status code.
+.TP
+.B \-\-status\-text <text>
+HTTP status text.
+.TP
+.B \-d, \-\-body <body>
+Response body as contentType:content.
+.TP
+.B \-\-headers <key:value>
+Replace response headers. Repeatable. (default: )
+.TP
+.B \-\-description <text>
+Example description.
+.TP
+.B \-\-rename <name>
+Rename the example.
+.TP
+.B \-\-url <url>
+Example request snapshot URL.
+.TP
+.B \-\-method <method>
+Example request snapshot method.
+.TP
+.B \-\-request\-headers <key:value>
+Replace request\-snapshot headers. Repeatable. (default: )
+.TP
+.B \-\-request\-param <key:value>
+Replace request\-snapshot query params. Repeatable. (default: )
+.TP
+.B \-\-request\-body <body>
+Example request snapshot body.
+.TP
+.B \-\-copy\-request
+Refresh example.request from the parent request.
+.TP
+.B \-\-clear\-request
+Remove the example.request snapshot.
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Example type for cloud mode: http. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.SS "collection example rm"
+Remove an example from a request.
+
+.B Usage:
+[options] <example>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection. Required.
+.TP
+.B \-\-request <id|name|path>
+Parent request (optional; disambiguates local names).
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector.
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Example type for cloud mode: http. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.SS "collection example get"
+Get a single example.
+
+.B Usage:
+[options] <example>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection. Required.
+.TP
+.B \-\-request <id|name|path>
+Parent request (optional; disambiguates local names).
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector.
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Example type for cloud mode: http. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.SS "collection example list"
+List examples under a request.
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection. Required.
+.TP
+.B \-\-request <id|name|path>
+Parent request (required).
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector.
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Example type for cloud mode: http. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.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 +1161,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.
@@ -1119,7 +1442,7 @@ Read and update environment variables.
 .B Subcommands:
 .TP
 .B environment var set
-Set one variable in an environment.
+Set one variable in an environment, or link it to a shared\-vault secret.
 .TP
 .B environment var get
 Read one variable value from an environment.
@@ -1128,16 +1451,25 @@ Read one variable value from an environment.
 Remove one variable from an environment.
 
 .SS "environment var set"
-Set one variable in an environment.
+Set one variable in an environment, or link it to a shared\-vault secret.
 
 .B Usage:
-[options] <key> <value>
+[options] <key> [value]
 
 .B Options:
 .TP
 .B \-e, \-\-environment <environment>
 Cloud Environment ID or local environment file path.
 .TP
+.B \-\-secret\-id <id>
+Link this variable to a shared\-vault secret instead of an inline value (from `secret create`'s output).
+.TP
+.B \-\-vault\-id <id>
+Vault id for \-\-secret\-id (auto\-resolved from \-\-workspace when omitted).
+.TP
+.B \-w, \-\-workspace <workspaceId>
+Workspace to resolve \-\-vault\-id from when \-\-secret\-id is given without \-\-vault\-id (falls back to .postman/resources.yaml).
+.TP
 .B \-\-verbose
 Verbose output
 .TP
@@ -1150,6 +1482,8 @@ Examples:
   postman environment var set baseUrl https://api.example.com \e
     \-\-environment ./postman/environments/dev.environment.yaml
   postman environment var set token abc123 \-\-environment 123456\-11111111\-2222\-3333\-4444\-555555555555
+  postman environment var set apiToken \-\-secret\-id b8748ab8\-d1bb\-477f\-95e2\-78625adea75f \e
+    \-\-environment 123456\-11111111\-2222\-3333\-4444\-555555555555 \-\-workspace <workspaceId>
 
 
 
@@ -1449,7 +1783,7 @@ List local spec files under a path, or (no path) a workspace's cloud specs.
 Read a spec definition, including every file of a multi\-file spec.
 .TP
 .B spec file
-Add, update, or remove files in a spec (cloud ID or local directory).
+Get, add, update, or remove files in a spec (cloud ID or local directory).
 .TP
 .B spec create
 Create a new spec in a workspace, or (with path) scaffold a local spec file.
@@ -1539,13 +1873,16 @@ Examples:
 
 
 .SS "spec file"
-Add, update, or remove files in a spec (cloud ID or local directory).
+Get, add, update, or remove files in a spec (cloud ID or local directory).
 
 .B Usage:
 [options] [command]
 
 .B Subcommands:
 .TP
+.B spec file get
+Show a file in a spec: its path, size and content.
+.TP
 .B spec file add
 Add a new file to a spec.
 .TP
@@ -1555,6 +1892,29 @@ Update an existing file in a spec.
 .B spec file rm
 Remove a file from a spec.
 
+.SS "spec file get"
+Show a file in a spec: its path, size and content.
+
+.B Usage:
+[options] <spec> <filePath>
+
+.B Options:
+.TP
+.B \-\-json
+Output as JSON
+.TP
+.B \-\-api\-key <key>
+Postman API key
+
+.TP Examples:
+
+Examples:
+  postman spec file get 12345678\-abcd\-1234\-abcd\-1234567890ab schemas/user.yaml
+  postman spec file get 12345678\-abcd\-1234\-abcd\-1234567890ab index.yaml \-\-json
+  postman spec file get ./postman/specs/api schemas/user.yaml
+
+
+
 .SS "spec file add"
 Add a new file to a spec.
 
@@ -1734,6 +2094,9 @@ Collection ID to sync (required for cloud mode)
 .TP
 .B \-\-api\-key <key>
 Postman API key
+.TP
+.B \-\-force
+Overwrite hand\-written scripts that the spec would otherwise drop
 
 .TP Examples:
 
@@ -1781,7 +2144,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 +2222,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 +2279,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 +2304,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 +2371,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 +2692,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 +2711,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 +2725,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 +2746,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 +2840,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 +2904,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 +2933,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 +2962,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 +3610,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
@@ -6613,6 +7034,50 @@ Examples:
 
 
 
+.SS "secret"
+Create and manage Postman secrets in a team's shared vault.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B secret create
+Create a secret in a team's shared vault.
+
+.SS "secret create"
+Create a secret in a team's shared vault.
+
+.B Usage:
+[options] <key>
+
+.B Options:
+.TP
+.B \-\-team\-id <id>
+Team id (defaults to your authenticated profile's team; must be your own team — the vault rejects any other team id, even one you otherwise have access to)
+.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
+.B \-\-value\-stdin
+Read the secret value from stdin instead of prompting
+
+.TP Examples:
+
+The secret value is never accepted as a command\-line argument. Provide it via:
+  \- an interactive masked prompt (default, when stdin is a terminal)
+  \- piped stdin: printf '%s' 's3cr3t' | postman secret create MY_SECRET
+  \- \-\-value\-stdin (explicit, same as piping)
+
+Examples:
+  postman secret create MY_SECRET \-\-team\-id 451 \-\-workspace 00000000\-0000\-0000\-0000\-000000000000
+  printf '%s' 's3cr3t' | postman secret create MY_SECRET \-\-team\-id 451 \-\-value\-stdin
+
+
+
 .SH SEE ALSO
 Full documentation: https://learning.postman.com/docs/postman\-cli/postman\-cli\-overview/
 .SH AUTHOR

package/package.json

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