postman-cli 1.60.0 → 1.62.0

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-09-21" "v1.60.0" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-09-22" "v1.62.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -145,6 +145,23 @@ Show the Postman account or guest session this CLI session is using.
 .B \-\-json
 Print current identity as machine\-readable JSON.
 
+.SS "feedback"
+Submit feedback about CLI usability, gaps, and improvement suggestions.
+
+.B Usage:
+[options] <text>
+
+.B Options:
+.TP
+.B \-\-type <type>
+Feedback type: cli_gap, improvement_suggestion, bug_report, feature_request, general (default: general)
+.TP
+.B \-\-context <context>
+Command or feature context this feedback is about
+.TP
+.B \-\-json
+Print result as machine\-readable JSON
+
 .SS "update"
 Update Postman CLI using the original installation method.
 
@@ -266,6 +283,9 @@ Score a Postman collection for AI readiness by ID, local file path, or local\-mo
 .B collection get
 Fetch a Postman collection in the V3 format and print it.
 .TP
+.B collection request
+Add, update, or remove requests in a local v3 collection.
+.TP
 .B collection list
 List collections: your local project's collections by default, or a Postman cloud workspace's collections with \-\-workspace.
 .TP
@@ -302,8 +322,8 @@ Examples:
 Without \-\-workspace this writes postman/collections/<name>/.resources/definition.yaml
 in the current directory, which must be a local Postman workspace (a directory holding
 \&.postman/ or postman/). Add requests as <request\-name>.request.yaml files beside it, then
-publish with `postman workspace push`. Creating a collection in a workspace requires
-authentication.
+publish with `postman workspace push`. Creating a collection in a workspace works with a
+signed\-in credential or with the guest session `postman init` mints.
 
 
 
@@ -377,6 +397,156 @@ Eg. postman collection get 12345\-33823532ab9e41c9b6fd12d0fd459b8b
     postman collection get 0123456789abcdef01234567 \-\-json
 
 
+.SS "collection request"
+Add, update, or remove requests in a local v3 collection.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B collection request add
+Add an empty request to a local v3 collection (set its details later with `update`).
+.TP
+.B collection request update
+Update a request in a v3 collection (only the fields you pass).
+.TP
+.B collection request rm
+Remove a request (any type) from a v3 collection.
+
+.SS "collection request add"
+Add an empty request to a local v3 collection (set its details later with `update`).
+
+.B Usage:
+[options] [request\-name]
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path. Required.
+.TP
+.B \-\-folder <id|name|path>
+Folder within the collection, e.g. "Users/Admin". Defaults to the root.
+.TP
+.B \-\-type <type>
+Request type: http, graphql, grpc, websocket, socketio. (default: http)
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+Creates an empty request (name + type only). Configure it with `collection request update`.
+
+Examples:
+  postman collection request add "Get user" \-\-collection "My API"
+  postman collection request add \-\-collection "My API"            # named "New request"
+  postman collection request add "List" \-\-collection "My API" \-\-folder Users \-\-type http
+
+
+
+.SS "collection request update"
+Update a request in a v3 collection (only the fields you pass).
+
+.B Usage:
+[options] <request>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path (cloud: id only). Required.
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector, e.g. "Users/Admin" (local: name/path; cloud: id).
+.TP
+.B \-\-rename <name>
+Rename the request (moves its file). Any request type.
+.TP
+.B \-\-url <url>
+Request URL. Any request type.
+.TP
+.B \-\-method <method>
+HTTP method (http requests only).
+.TP
+.B \-\-param <key:value>
+Replace query parameters. Repeatable (http requests only). (default: )
+.TP
+.B \-d, \-\-body <body>
+Request payload (inline, @file, or \- for stdin), interpreted by request type. For http, an optional "<type>:" prefix picks the content type: json/text/xml/html/javascript, file:<path>, urlencoded:key=v&k2=v2, or formdata:key=v&file=@path.
+.TP
+.B \-\-variables <json>
+GraphQL variables JSON (graphql requests only).
+.TP
+.B \-\-description <text>
+Request description.
+.TP
+.B \-\-headers <key:value>
+Replace request headers. Repeatable; any request type with headers. (default: )
+.TP
+.B \-\-auth <spec>
+Request auth: none, inherit, bearer:TOKEN, basic:USER:PASS, apikey:KEY:VALUE[:header|query], oauth2:TOKEN. Any request type.
+.TP
+.B \-\-scripts <event:script>
+Replace scripts. event is prerequest or test; script is @file, \- for stdin, or inline. Repeatable; any request type. (default: )
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Request type for cloud mode: http, graphql, grpc, websocket, socketio. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+Works on any request type; \-\-rename/\-\-url/\-\-description/\-\-headers/\-\-auth/\-\-scripts apply to all, while \-\-method/\-\-param/\-\-body are http\-only. 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 too.
+
+Examples:
+  postman collection request update "Get user" \-\-collection "My API" \-\-url "{{baseUrl}}/users/:id"
+  postman collection request update "Get user" \-\-collection "My API" \-\-folder Users \-\-rename "Fetch user"
+  postman collection request update "Get user" \-\-collection "My API" \-\-headers "Authorization:Bearer x" \-\-auth bearer:TOKEN \-\-scripts "test:@check.js"
+  postman collection request update <requestId> \-\-collection <collectionId> \-\-url "..." \-w <workspaceId>
+
+
+
+.SS "collection request rm"
+Remove a request (any type) from a v3 collection.
+
+.B Usage:
+[options] <request>
+
+.B Options:
+.TP
+.B \-\-collection <id|name>
+Target collection: name, directory, id, cloud id, or path (cloud: id only). Required.
+.TP
+.B \-\-folder <id|name|path>
+Folder to scope the request selector, e.g. "Users/Admin" (local: name/path; cloud: id).
+.TP
+.B \-w, \-\-workspace <id>
+Target a Postman cloud workspace by id (cloud mode).
+.TP
+.B \-\-type <type>
+Request type for cloud mode: http, graphql, grpc, websocket, socketio. (default: http)
+.TP
+.B \-\-json
+JSON output.
+
+.TP Examples:
+
+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 too.
+
+Examples:
+  postman collection request rm "Get user" \-\-collection "My API"
+  postman collection request rm "Get user" \-\-collection "My API" \-\-folder Users
+  postman collection request rm <requestId> \-\-collection <collectionId> \-w <workspaceId>
+
+
+
 .SS "collection list"
 List collections: your local project's collections by default, or a Postman cloud workspace's collections with \-\-workspace.
 
@@ -1358,7 +1528,7 @@ Invoke a monitor run and display results.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-x, \-\-suppress\-exit\-code
 Specify whether or not to override the default exit code for the current run
@@ -1444,7 +1614,7 @@ How iteration data is consumed, for example round_robin, repeat_last or stop_at_
 Do not trigger an immediate run after creating the monitor
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output as JSON instead of a table
@@ -1528,7 +1698,7 @@ Number of iterations to run
 How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires \-\-iteration\-count, \-\-dataset\-id and \-\-dataset\-view\-id)
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output as JSON instead of a table
@@ -1557,7 +1727,7 @@ Permanently delete a monitor. Prompts for confirmation unless \-\-yes is passed.
 Skip the confirmation prompt
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output the outcome, including any failure, as JSON instead of a plain message
@@ -1668,7 +1838,7 @@ List the monitors visible to you.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-w, \-\-workspace <id>
 Filter to monitors in this workspace
@@ -1731,7 +1901,7 @@ Show a monitor's configuration.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output as JSON instead of a table
@@ -1751,7 +1921,7 @@ Show per\-request latency and outcome history for a monitor.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-since <dateTime>
 Only executions at or after this ISO 8601 date\-time (defaults to 7 days ago)
@@ -1785,7 +1955,7 @@ Pause a monitor, so it stops firing on schedule.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output as JSON instead of a table
@@ -1799,7 +1969,7 @@ Resume a paused monitor, so it fires on schedule again.
 .B Options:
 .TP
 .B \-\-api\-key <key>
-Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)
+Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)
 .TP
 .B \-\-json
 Output as JSON instead of a table
@@ -1969,7 +2139,7 @@ Create a Postman workspace and bind it to this git repository.
 .B Options:
 .TP
 .B \-\-visibility <status>
-Required. Workspace visibility, e.g. personal or team
+Required. One of: personal, private, team, public, partner.
 .TP
 .B \-\-name <name>
 Workspace name (defaults to owner/repo from the git remote)
@@ -1977,6 +2147,12 @@ Workspace name (defaults to owner/repo from the git remote)
 .B \-\-summary <text>
 Optional workspace summary
 .TP
+.B \-\-team\-id <id>
+The team inside your organisation the workspace belongs to. Required for a team workspace when your organisation has teams inside it. Find it with `postman team list`.
+.TP
+.B \-\-team\-role <level>
+What a team or public workspace grants: view or edit. Applies to the team named by \-\-team\-id, or to your whole organisation when none is named. Defaults to your team's configured default.
+.TP
 .B \-\-path <dir>
 Directory to bind (defaults to the current directory)
 .TP
@@ -1994,6 +2170,8 @@ Refuses to run on CI: create once locally and commit the binding.
 Examples:
   $ postman workspace create \-\-visibility personal
   $ postman workspace create \-\-visibility team \-\-name "acme/orders"
+  $ postman workspace create \-\-visibility team \-\-team\-id 451
+  $ postman workspace create \-\-visibility team \-\-team\-role view
   $ postman workspace create \-\-visibility personal \-\-no\-connect
 
 
@@ -2090,6 +2268,58 @@ Examples:
 
 
 
+.SS "team"
+Work with the teams inside your organisation.
+
+.B Usage:
+[options] [command]
+
+.TP Examples:
+
+These are the teams inside an organisation, which the Postman app shows
+under "Teams". The organisation itself is what `postman whoami` reports
+as your team. A Postman team that is not an organisation has none.
+
+
+
+.B Subcommands:
+.TP
+.B team list
+List the teams inside your organisation.
+
+.SS "team list"
+List the teams inside your organisation.
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-\-can\-create\-workspace
+Only list teams you could create a workspace in.
+.TP
+.B \-\-json
+Print the list as machine\-readable JSON.
+.TP
+.B \-\-timeout <ms>
+Abort the run after this many milliseconds. Defaults to 30000.
+
+.TP Examples:
+
+Requires a login (`postman login`) or POSTMAN_API_KEY.
+These are the teams inside your organisation. The organisation itself is
+what `postman whoami` reports as your team. `postman workspace create
+\-\-team\-id <id>` takes the id from this list.
+
+A Postman team that is not an organisation has no teams inside it, so this
+lists nothing and exits 0.
+
+Examples:
+  $ postman team list
+  $ postman team list \-\-can\-create\-workspace
+  $ postman team list \-\-json
+
+
 .SS "performance"
 Manage performance tests on your collections.
 
@@ -2148,6 +2378,9 @@ How rows map to VUs: round\-robin (default), fixed, random
 .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
+.B \-\-output <format>
+Output format for live results: auto (default, interactive dashboard) or ndjson (one JSON object per line on stdout, ending with a "summary" event — for CI or other non\-interactive use) (default: auto)
+.TP
 .B \-\-runner <runner>
 Runner to execute the performance test on: local, postman\-cloud, or postman\-cloud\-static\-ip (egress from your account region's static\-IP cluster) (default: )
 .TP
@@ -3710,7 +3943,7 @@ Start mocks with fault\-injection scenarios defined in a .sim.yaml file
 .B Usage:
 [options] <filepath>
 
-.SS "context"
+.SS "describe"
 [Beta] Get API context for AI coding agents directly from the command line.
 
 
@@ -3719,7 +3952,7 @@ Start mocks with fault\-injection scenarios defined in a .sim.yaml file
 
 .B Subcommands:
 .TP
-.B context instructions
+.B describe instructions
 Get agent instructions for using Postman Context with AI coding agents.
 
 Topics:
@@ -3729,25 +3962,25 @@ Topics:
   maintenance     — Agent instructions for maintaining and updating client code
 
 .TP
-.B context collection
+.B describe collection
 Collection commands
 .TP
-.B context request
+.B describe request
 Request commands
 .TP
-.B context folder
+.B describe folder
 Folder commands
 .TP
-.B context response
+.B describe response
 Response commands
 .TP
-.B context workspace
+.B describe workspace
 Workspace commands
 .TP
-.B context environment
+.B describe environment
 Environment commands
 
-.SS "context instructions"
+.SS "describe instructions"
 Get agent instructions for using Postman Context with AI coding agents.
 
 Topics:
@@ -3760,7 +3993,7 @@ Topics:
 .B Usage:
 [options] [topic]
 
-.SS "context collection"
+.SS "describe collection"
 Collection commands
 
 .B Usage:
@@ -3768,13 +4001,13 @@ Collection commands
 
 .B Subcommands:
 .TP
-.B context collection get
+.B describe collection get
 Get a collection's metadata and a map of its folders and requests.
 
 Returns collection info (name, description, variables, auth) plus a
 recursive tree of folders and requests.
 
-.SS "context collection get"
+.SS "describe collection get"
 Get a collection's metadata and a map of its folders and requests.
 
 Returns collection info (name, description, variables, auth) plus a
@@ -3788,7 +4021,7 @@ recursive tree of folders and requests.
 .B \-c, \-\-collection\-id <id>
 Collection ID
 
-.SS "context request"
+.SS "describe request"
 Request commands
 
 .B Usage:
@@ -3796,10 +4029,10 @@ Request commands
 
 .B Subcommands:
 .TP
-.B context request get
+.B describe request get
 Get a request from a collection
 .TP
-.B context request context
+.B describe request context
 Fetch all context about a request and return it as a Markdown document.
 
 Returns: collection metadata, request details (method, URL, headers, body,
@@ -3807,9 +4040,9 @@ auth, docs), parent folder documentation, response examples, and
 environment variables.
 
 Examples:
-  postman context request context \-c <collection\-id> \-r <request\-id>
+  postman describe request context \-c <collection\-id> \-r <request\-id>
 
-.SS "context request get"
+.SS "describe request get"
 Get a request from a collection
 
 .B Usage:
@@ -3823,7 +4056,7 @@ Request ID
 .B \-c, \-\-collection\-id <id>
 Collection ID
 
-.SS "context request context"
+.SS "describe request context"
 Fetch all context about a request and return it as a Markdown document.
 
 Returns: collection metadata, request details (method, URL, headers, body,
@@ -3831,7 +4064,7 @@ auth, docs), parent folder documentation, response examples, and
 environment variables.
 
 Examples:
-  postman context request context \-c <collection\-id> \-r <request\-id>
+  postman describe request context \-c <collection\-id> \-r <request\-id>
 
 .B Usage:
 [options]
@@ -3844,7 +4077,7 @@ Collection ID
 .B \-r, \-\-request\-id <id>
 Request ID
 
-.SS "context folder"
+.SS "describe folder"
 Folder commands
 
 .B Usage:
@@ -3852,10 +4085,10 @@ Folder commands
 
 .B Subcommands:
 .TP
-.B context folder get
+.B describe folder get
 Get a folder from a collection
 
-.SS "context folder get"
+.SS "describe folder get"
 Get a folder from a collection
 
 .B Usage:
@@ -3869,7 +4102,7 @@ Folder ID
 .B \-c, \-\-collection\-id <id>
 Collection ID
 
-.SS "context response"
+.SS "describe response"
 Response commands
 
 .B Usage:
@@ -3877,10 +4110,10 @@ Response commands
 
 .B Subcommands:
 .TP
-.B context response get
+.B describe response get
 Get a saved response example from a collection
 
-.SS "context response get"
+.SS "describe response get"
 Get a saved response example from a collection
 
 .B Usage:
@@ -3897,7 +4130,7 @@ Collection ID
 .B \-r, \-\-request\-id <id>
 Request ID
 
-.SS "context workspace"
+.SS "describe workspace"
 Workspace commands
 
 .B Usage:
@@ -3905,10 +4138,10 @@ Workspace commands
 
 .B Subcommands:
 .TP
-.B context workspace get
+.B describe workspace get
 Get a workspace by ID
 
-.SS "context workspace get"
+.SS "describe workspace get"
 Get a workspace by ID
 
 .B Usage:
@@ -3919,7 +4152,7 @@ Get a workspace by ID
 .B \-w, \-\-workspace\-id <id>
 Workspace ID
 
-.SS "context environment"
+.SS "describe environment"
 Environment commands
 
 .B Usage:
@@ -3927,10 +4160,10 @@ Environment commands
 
 .B Subcommands:
 .TP
-.B context environment get
+.B describe environment get
 Get a single environment by ID
 
-.SS "context environment get"
+.SS "describe environment get"
 Get a single environment by ID
 
 .B Usage:

package/package.json

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