postman-cli 1.39.2 → 1.40.0

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-06-18" "v1.39.2" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-06-24" "v1.40.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -169,6 +169,15 @@ Define the number of iterations to run
 .B \-d, \-\-iteration\-data <path>
 Specify a data file to use for iterations (either JSON or CSV)
 .TP
+.B \-\-iteration\-data\-dataset <path>
+[BETA] Path to a .dataset.yaml whose view drives the iteration data. Mutually exclusive with \-\-iteration\-data. Requires \-\-iteration\-data\-view.
+.TP
+.B \-\-iteration\-data\-view <nameOrId>
+[BETA] Name or id of the view to execute (within \-\-iteration\-data\-dataset). The view's result set drives one iteration per row.
+.TP
+.B \-\-dataset <pathOrDir>
+[BETA] Pass \-\-dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto\-discovery of .dataset.yaml files from the collection's parent repo is disabled. (default: )
+.TP
 .B \-i <id>
 Specify the request/folder id, name, or path to run from the collection. Use a path (e.g. "FolderName/RequestName") to disambiguate items with the same name. Can be specified multiple times to run multiple items (default: )
 .TP
@@ -562,6 +571,9 @@ Path to a JSON or CSV data file to use with the collection
 .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 \-\-cloud
+Execute the performance test on Postman Cloud (beta) (default: false)
+.TP
 .B \-\-pass\-if <condition>
 Pass condition in format: function(metric, value). 
 Functions: less_than, greater_than, less_than_eq, greater_than_eq. 
@@ -962,6 +974,9 @@ Add JavaScript script to run before the request. Can be inline JS or @filepath t
 .B \-\-script\-post\-request <script>
 Add JavaScript script to run after the request. Can be inline JS or @filepath to load from file. Scripts have access to pm.* APIs. Example: \-\-script\-post\-request "console.log(pm.response.json());" or \-\-script\-post\-request @validate.js
 .TP
+.B \-\-dataset <pathOrDir>
+[BETA] Pass \-\-dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to pre/post\-request scripts as pm.datasets(<id>). (default: )
+.TP
 .B \-o, \-\-output <path>
 Save complete response to JSON file.Useful for debugging or further processing.
 .TP
@@ -2604,6 +2619,420 @@ Examples:
 
 
 
+.SS "dataset"
+[BETA] Work with Postman datasets defined in local YAML files.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B dataset list
+[BETA] List dataset YAMLs under the given directory, or print summary for a single YAML file.
+.TP
+.B dataset get
+[BETA] Print a dataset's metadata and structure summary.
+.TP
+.B dataset query
+[BETA] Run an ad\-hoc SQL query against a dataset.
+.TP
+.B dataset create
+[BETA] Scaffold a new empty .dataset.yaml file at <path>.
+.TP
+.B dataset delete
+[BETA] Permanently remove a dataset's .dataset.yaml file and its .resources/ directory.
+.TP
+.B dataset source
+[BETA] Inspect and manage a dataset's datasources.
+.TP
+.B dataset view
+[BETA] Inspect and manage saved views on a dataset.
+
+.SS "dataset list"
+[BETA] List dataset YAMLs under the given directory, or print summary for a single YAML file.
+
+.B Usage:
+[options] <pathOrDir>
+
+.B Options:
+.TP
+.B \-\-json
+Output as JSON instead of a table
+
+.TP Examples:
+
+Examples:
+  postman dataset list ./postman/datasets
+  postman dataset list ./postman/datasets/users/users.dataset.yaml
+
+
+
+.SS "dataset get"
+[BETA] Print a dataset's metadata and structure summary.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-\-json
+Output the full parsed YAML as JSON
+
+.TP Examples:
+
+Examples:
+  postman dataset get ./postman/datasets/users/users.dataset.yaml
+
+
+
+.SS "dataset query"
+[BETA] Run an ad\-hoc SQL query against a dataset.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-q, \-\-query <sql>
+SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")
+.TP
+.B \-p, \-\-param <value...>
+Positional parameter values for $1, $2, ... bindings; repeatable
+.TP
+.B \-\-json
+Output rows as JSON instead of a table
+
+.TP Examples:
+
+Examples:
+  postman dataset query ./users.dataset.yaml \-q "SELECT * FROM source_users LIMIT 5"
+  postman dataset query ./users.dataset.yaml \-q "SELECT * FROM source_users WHERE id = $1" \-p 42
+
+
+
+.SS "dataset create"
+[BETA] Scaffold a new empty .dataset.yaml file at <path>.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-n, \-\-name <name>
+Human\-readable name for the dataset
+.TP
+.B \-d, \-\-description <desc>
+Optional description
+.TP
+.B \-\-id <uuid>
+Override the generated dataset id (defaults to a random v4 UUID)
+.TP
+.B \-\-force
+Overwrite an existing file at <path>
+
+.TP Examples:
+
+Examples:
+  postman dataset create ./postman/datasets/users/users.dataset.yaml \-\-name "Users"
+
+
+
+.SS "dataset delete"
+[BETA] Permanently remove a dataset's .dataset.yaml file and its .resources/ directory.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-y, \-\-yes
+Skip the confirmation prompt
+.TP
+.B \-\-keep\-resources
+Delete only the YAML file; leave the .resources/ directory intact
+
+.TP Examples:
+
+Examples:
+  postman dataset delete ./postman/datasets/users/users.dataset.yaml
+  postman dataset delete ./postman/datasets/users/users.dataset.yaml \-\-yes
+
+
+
+.SS "dataset source"
+[BETA] Inspect and manage a dataset's datasources.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B dataset source list
+[BETA] List the datasources defined on a dataset.
+.TP
+.B dataset source add
+[BETA] Add a datasource to a dataset.
+.TP
+.B dataset source remove
+[BETA] Remove a datasource from a dataset.
+.TP
+.B dataset source update
+[BETA] Update fields on an existing datasource. Only the flags you provide are changed.
+
+.SS "dataset source list"
+[BETA] List the datasources defined on a dataset.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-\-json
+Output sources as JSON instead of a table
+
+.TP Examples:
+
+Examples:
+  postman dataset source list ./postman/datasets/users/users.dataset.yaml
+
+
+
+.SS "dataset source add"
+[BETA] Add a datasource to a dataset.
+
+.B Usage:
+[options] <pathOrId>
+
+.B Options:
+.TP
+.B \-n, \-\-name <name>
+Logical name for the source (becomes the SQL table name)
+.TP
+.B \-\-id <uuid>
+Override the generated source id
+.TP
+.B \-\-format <csv|json|mysql|postgres>
+Override the inferred format
+.TP
+.B \-\-type <local|remote\-url|mysql|postgresql>
+Source kind; inferred from \-\-file/\-\-url when omitted
+.TP
+.B \-\-file <path>
+Path to a local CSV/JSON file (absolute or cwd\-relative)
+.TP
+.B \-\-ref\-only
+Reference the file in place; do NOT copy into data_dir
+.TP
+.B \-\-force
+When copying, overwrite an existing file at the destination
+.TP
+.B \-\-url <url>
+HTTP(S) URL to a remote CSV/JSON file
+.TP
+.B \-\-host <host>
+DB host (mysql/postgresql)
+.TP
+.B \-\-port <port>
+DB port
+.TP
+.B \-\-user <user>
+DB user (warning: stored as plaintext in the YAML).
+.TP
+.B \-\-password <password>
+DB password (warning: stored as plaintext in the YAML).
+.TP
+.B \-\-database <db>
+DB database name
+.TP
+.B \-\-table <table>
+DB table name (optional)
+.TP
+.B \-\-slug <slug>
+Optional slug for the source
+
+.SS "dataset source remove"
+[BETA] Remove a datasource from a dataset.
+
+.B Usage:
+[options] <path> <sourceNameOrId>
+
+.TP Examples:
+
+Examples:
+  postman dataset source remove ./users.dataset.yaml source_people_1
+  postman dataset source remove ./users.dataset.yaml d3e67bc9\-f9a3\-43b5\-b894\-d00f1791258c
+
+
+
+.SS "dataset source update"
+[BETA] Update fields on an existing datasource. Only the flags you provide are changed.
+
+.B Usage:
+[options] <pathOrId> <sourceNameOrId>
+
+.B Options:
+.TP
+.B \-n, \-\-name <name>
+Rename the source
+.TP
+.B \-\-format <csv|json|mysql|postgres>
+Change the format
+.TP
+.B \-\-file <path>
+Replace the source's file (local\-filesystem only)
+.TP
+.B \-\-ref\-only
+When using \-\-file, reference in place instead of copying
+.TP
+.B \-\-force
+When copying with \-\-file, overwrite existing destination
+.TP
+.B \-\-url <url>
+Replace the remote URL (remote\-url only)
+.TP
+.B \-\-host <host>
+Update DB host (mysql/postgresql)
+.TP
+.B \-\-port <port>
+Update DB port
+.TP
+.B \-\-user <user>
+Update DB user (warning: stored as plaintext in the YAML).
+.TP
+.B \-\-password <password>
+Update DB password (warning: stored as plaintext in the YAML).
+.TP
+.B \-\-database <db>
+Update DB database name
+.TP
+.B \-\-table <table>
+Update DB table name
+.TP
+.B \-\-slug <slug>
+Update slug
+
+.SS "dataset view"
+[BETA] Inspect and manage saved views on a dataset.
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B dataset view list
+[BETA] List the saved views defined on a dataset.
+.TP
+.B dataset view run
+[BETA] Execute a saved view against a dataset and print the rows.
+.TP
+.B dataset view create
+[BETA] Add a saved view to a dataset.
+.TP
+.B dataset view delete
+[BETA] Remove a saved view from a dataset.
+.TP
+.B dataset view update
+[BETA] Update name and/or query on an existing view.
+
+.SS "dataset view list"
+[BETA] List the saved views defined on a dataset.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-\-json
+Output views as JSON instead of a table
+
+.TP Examples:
+
+Examples:
+  postman dataset view list ./postman/datasets/users/users.dataset.yaml
+
+
+
+.SS "dataset view run"
+[BETA] Execute a saved view against a dataset and print the rows.
+
+.B Usage:
+[options] <path> <viewNameOrId>
+
+.B Options:
+.TP
+.B \-p, \-\-param <value...>
+Positional parameter values for $1, $2, ... bindings; repeatable
+.TP
+.B \-\-json
+Output rows as JSON instead of a table
+
+.TP Examples:
+
+Examples:
+  postman dataset view run ./users.dataset.yaml "Active Users"
+  postman dataset view run ./users.dataset.yaml ea748a6a\-ed3c\-496d\-b91e\-6ccc8e4d0e9d
+
+
+
+.SS "dataset view create"
+[BETA] Add a saved view to a dataset.
+
+.B Usage:
+[options] <path>
+
+.B Options:
+.TP
+.B \-n, \-\-name <name>
+View name
+.TP
+.B \-q, \-\-query <sql>
+SQL query the view executes
+.TP
+.B \-\-id <uuid>
+Override the generated view id
+
+.TP Examples:
+
+Examples:
+  postman dataset view create ./users.dataset.yaml \e
+    \-n "Active Users" \-q "SELECT * FROM source_users WHERE active = true"
+
+
+
+.SS "dataset view delete"
+[BETA] Remove a saved view from a dataset.
+
+.B Usage:
+[options] <path> <viewNameOrId>
+
+.TP Examples:
+
+Examples:
+  postman dataset view delete ./users.dataset.yaml "Active Users"
+
+
+
+.SS "dataset view update"
+[BETA] Update name and/or query on an existing view.
+
+.B Usage:
+[options] <path> <viewNameOrId>
+
+.B Options:
+.TP
+.B \-n, \-\-name <name>
+New view name
+.TP
+.B \-q, \-\-query <sql>
+New SQL query
+
+.TP Examples:
+
+Examples:
+  postman dataset view update ./users.dataset.yaml "Active Users" \-q "SELECT ..."
+
+
+
 .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.39.2",
+  "version": "1.40.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.39.2",
-    "@postman/pm-bin-macos-x64": "1.39.2",
-    "@postman/pm-bin-linux-x64": "1.39.2",
-    "@postman/pm-bin-linux-arm64": "1.39.2",
-    "@postman/pm-bin-windows-x64": "1.39.2"
+    "@postman/pm-bin-macos-arm64": "1.40.0",
+    "@postman/pm-bin-macos-x64": "1.40.0",
+    "@postman/pm-bin-linux-x64": "1.40.0",
+    "@postman/pm-bin-linux-arm64": "1.40.0",
+    "@postman/pm-bin-windows-x64": "1.40.0"
   }
 }