postman-cli 1.48.0 → 1.49.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/man/postman.1 +55 -12
  2. package/package.json +6 -6
package/man/postman.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH POSTMAN 1 "2026-08-19" "v1.48.0" "Postman CLI Manual"
1
+ .TH POSTMAN 1 "2026-08-21" "v1.49.0" "Postman CLI Manual"
2
2
  .SH NAME
3
3
  postman \- Command\-line companion utility for Postman
4
4
  .SH SYNOPSIS
@@ -706,14 +706,8 @@ Use a Postman Dataset as iteration data (with \-\-dataset\-view\-id)
706
706
  .B \-\-dataset\-view\-id <id>
707
707
  Dataset view to execute for iteration data (requires \-\-dataset\-id)
708
708
  .TP
709
- .B \-\-dataset\-offset <offset>
710
- Row offset into the view result (optional range)
711
- .TP
712
- .B \-\-dataset\-limit <limit>
713
- Max rows to fetch from the view (optional range)
714
- .TP
715
709
  .B \-\-dataset\-distribution <strategy>
716
- How rows map to VUs: round\-robin (default), pinned, random
710
+ How rows map to VUs: round\-robin (default), fixed, random
717
711
  .TP
718
712
  .B \-\-postman\-api\-key <apiKey>
719
713
  API Key used to load the resources from the Postman API (Only supported in the US region, use 'postman login \-\-region' to authenticate instead)
@@ -913,14 +907,14 @@ Set flow inputs from JSON files (e.g. \-\-input\-file ./inputs.json \-\-input\-f
913
907
  .B \-s, \-\-scenario <name>
914
908
  Use a pre\-built scenario as flow inputs (by scenario name). Can be combined with \-\-input and \-\-input\-file to override values.
915
909
  .TP
916
- .B \-\-iteration\-data\-dataset <path>
917
- [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).
910
+ .B \-\-iteration\-data\-dataset <pathOrId>
911
+ [BETA] Run the flow once per row of a dataset view. Accepts a local .dataset.yaml path or a cloud dataset id (cloud requires login). Requires \-\-iteration\-data\-view. Dataset columns feed the flow inputs (see \-\-map\-column).
918
912
  .TP
919
913
  .B \-\-iteration\-data\-view <nameOrId>
920
914
  [BETA] Name or id of the view (within \-\-iteration\-data\-dataset) whose rows drive the run.
921
915
  .TP
922
- .B \-\-map <input=column>
923
- [BETA] Bind a flow input to a dataset column (e.g. \-\-map isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default: )
916
+ .B \-m, \-\-map\-column <input=column>
917
+ [BETA] Bind a flow input to a dataset column (e.g. \-m isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default: )
924
918
  .TP
925
919
  .B \-e, \-\-environment <path>
926
920
  Specify a path to a Postman Environment file (JSON or YAML)
@@ -928,6 +922,9 @@ Specify a path to a Postman Environment file (JSON or YAML)
928
922
  .B \-\-working\-dir <path>
929
923
  Specify the path to the working directory
930
924
  .TP
925
+ .B \-\-no\-insecure\-file\-read
926
+ Prevent reading dataset files situated outside of the working directory (applies to \-\-iteration\-data\-dataset)
927
+ .TP
931
928
  .B \-\-verbose
932
929
  Show detailed information of flow run and each request (method, URL, assertions)
933
930
  .TP
@@ -965,6 +962,9 @@ Example:
965
962
  postman flows run ./path/to/flow.json \-\-output json
966
963
  postman flows run ./path/to/flow.json \-\-reporters html
967
964
  postman flows run ./path/to/flow.json \-\-workspace <workspaceId>
965
+ postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users"
966
+ postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users" \-\-map\-column isActive=active
967
+ postman flows run ./path/to/flow.json \-\-iteration\-data\-dataset ./users.dataset.yaml \-\-iteration\-data\-view "active\-users" \-i region=us\-east
968
968
 
969
969
 
970
970
 
@@ -2729,6 +2729,9 @@ Show details for a webhook.
2729
2729
  .B webhook requests
2730
2730
  List, inspect, and replay requests received by a webhook.
2731
2731
  .TP
2732
+ .B webhook scripts
2733
+ Create or update scripts executed by a webhook.
2734
+ .TP
2732
2735
  .B webhook forward
2733
2736
  Forward incoming webhook requests to a local port.
2734
2737
 
@@ -2921,11 +2924,15 @@ Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.j
2921
2924
  .TP
2922
2925
  .B \-\-api\-key <key>
2923
2926
  Postman API key
2927
+ .TP
2928
+ .B \-\-verbose
2929
+ Show script execution logs
2924
2930
 
2925
2931
  .TP Examples:
2926
2932
 
2927
2933
  Examples:
2928
2934
  postman webhook requests describe 0123456789abcdefghijklmno 11111111\-1111\-4111\-8111\-111111111111
2935
+ postman webhook requests describe 0123456789abcdefghijklmno 11111111\-1111\-4111\-8111\-111111111111 \-\-verbose
2929
2936
 
2930
2937
 
2931
2938
 
@@ -2950,6 +2957,42 @@ Examples:
2950
2957
 
2951
2958
 
2952
2959
 
2960
+ .SS "webhook scripts"
2961
+ Create or update scripts executed by a webhook.
2962
+
2963
+ .B Usage:
2964
+ [options] [command]
2965
+
2966
+ .B Subcommands:
2967
+ .TP
2968
+ .B webhook scripts set
2969
+ Create or update a webhook script from a JavaScript or TypeScript file.
2970
+
2971
+ .SS "webhook scripts set"
2972
+ Create or update a webhook script from a JavaScript or TypeScript file.
2973
+
2974
+ .B Usage:
2975
+ [options] <webhookId> <scriptPath>
2976
+
2977
+ .B Options:
2978
+ .TP
2979
+ .B \-\-event <event>
2980
+ Script event: onEvent or onResponse
2981
+ .TP
2982
+ .B \-w, \-\-workspace <workspaceId>
2983
+ Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)
2984
+ .TP
2985
+ .B \-\-api\-key <key>
2986
+ Postman API key
2987
+
2988
+ .TP Examples:
2989
+
2990
+ Examples:
2991
+ postman webhook scripts set 0123456789abcdefghijklmno ./on\-event.js \-\-event onEvent
2992
+ postman webhook scripts set 0123456789abcdefghijklmno ./on\-response.js \-\-event onResponse
2993
+
2994
+
2995
+
2953
2996
  .SS "webhook forward"
2954
2997
  Forward incoming webhook requests to a local port.
2955
2998
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "postman-cli",
3
- "version": "1.48.0",
3
+ "version": "1.49.0",
4
4
  "description": "Official Postman CLI - Command-line companion for API development, testing, and automation",
5
5
  "keywords": [
6
6
  "postman",
@@ -58,10 +58,10 @@
58
58
  "man/"
59
59
  ],
60
60
  "optionalDependencies": {
61
- "@postman/pm-bin-macos-arm64": "1.48.0",
62
- "@postman/pm-bin-macos-x64": "1.48.0",
63
- "@postman/pm-bin-linux-x64": "1.48.0",
64
- "@postman/pm-bin-linux-arm64": "1.48.0",
65
- "@postman/pm-bin-windows-x64": "1.48.0"
61
+ "@postman/pm-bin-macos-arm64": "1.49.0",
62
+ "@postman/pm-bin-macos-x64": "1.49.0",
63
+ "@postman/pm-bin-linux-x64": "1.49.0",
64
+ "@postman/pm-bin-linux-arm64": "1.49.0",
65
+ "@postman/pm-bin-windows-x64": "1.49.0"
66
66
  }
67
67
  }