postman-cli-completion 1.48.0 → 1.51.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.
package/README.md CHANGED
@@ -10,6 +10,8 @@ Completes:
10
10
 
11
11
  Dynamic completion of remote IDs (collection / workspace / monitor IDs) is **not** supported — paste those yourself.
12
12
 
13
+ ![postman-cli-completion anime gif](assets/postman-cli-completion.gif)
14
+
13
15
  ## Install
14
16
 
15
17
  ### Via npm (recommended)
@@ -1,4 +1,4 @@
1
- # Bash completion for Postman CLI (postman v1.48.0)
1
+ # Bash completion for Postman CLI (postman v1.51.0)
2
2
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
3
3
  # Source: spec/commands.json
4
4
  # https://github.com/yokawasa/postman-cli-completion
@@ -382,7 +382,7 @@ _postman_workspace() {
382
382
  if [[ "$cur" == -* ]]; then
383
383
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
384
384
  else
385
- COMPREPLY=( $(compgen -W "list prepare push lint" -- "$cur") )
385
+ COMPREPLY=( $(compgen -W "list prepare push lint pull connect-git" -- "$cur") )
386
386
  fi
387
387
  return 0
388
388
  fi
@@ -391,6 +391,8 @@ _postman_workspace() {
391
391
  prepare) _postman_workspace_prepare ;;
392
392
  push) _postman_workspace_push ;;
393
393
  lint) _postman_workspace_lint ;;
394
+ pull) _postman_workspace_pull ;;
395
+ connect-git) _postman_workspace_connect_git ;;
394
396
  esac
395
397
  }
396
398
 
@@ -421,13 +423,30 @@ _postman_workspace_push() {
421
423
 
422
424
  _postman_workspace_lint() {
423
425
  if [[ "$cur" == -* ]]; then
424
- COMPREPLY=( $(compgen -W "-f --fail-severity -o --output --meta --workspace-id -h --help" -- "$cur") )
426
+ COMPREPLY=( $(compgen -W "-f --fail-severity -o --output --meta --workspace-id --fix -h --help" -- "$cur") )
425
427
  return 0
426
428
  fi
427
429
  case "$prev" in
428
430
  esac
429
431
  }
430
432
 
433
+ _postman_workspace_pull() {
434
+ if [[ "$cur" == -* ]]; then
435
+ COMPREPLY=( $(compgen -W "-y --yes --source-workspace --verbose -h --help" -- "$cur") )
436
+ return 0
437
+ fi
438
+ case "$prev" in
439
+ esac
440
+ }
441
+
442
+ _postman_workspace_connect_git() {
443
+ if [[ "$cur" == -* ]]; then
444
+ COMPREPLY=( $(compgen -W "--verbose -h --help" -- "$cur") )
445
+ return 0
446
+ fi
447
+ _postman_filematch '!*.@(json)' "$cur"
448
+ }
449
+
431
450
  _postman_performance() {
432
451
  if [[ -z "$subcmd" ]]; then
433
452
  if [[ "$cur" == -* ]]; then
@@ -444,7 +463,7 @@ _postman_performance() {
444
463
 
445
464
  _postman_performance_run() {
446
465
  if [[ "$cur" == -* ]]; then
447
- COMPREPLY=( $(compgen -W "-e --environment -g --globals --vu-count -d --duration -p --load-profile --data-file --postman-api-key --pass-if -h --help" -- "$cur") )
466
+ COMPREPLY=( $(compgen -W "-e --environment -g --globals --vu-count -d --duration -p --load-profile --data-file --dataset-id --dataset-view-id --dataset-distribution --postman-api-key --runner --pass-if -h --help" -- "$cur") )
448
467
  return 0
449
468
  fi
450
469
  case "$prev" in
@@ -519,7 +538,7 @@ _postman_flows_deploy() {
519
538
 
520
539
  _postman_flows_run() {
521
540
  if [[ "$cur" == -* ]]; then
522
- COMPREPLY=( $(compgen -W "-i --input -f --input-file -s --scenario -e --environment --working-dir --verbose --no-truncate --output --reporters -x --suppress-exit-code --workspace --verbose --debug --json -h --help" -- "$cur") )
541
+ COMPREPLY=( $(compgen -W "-i --input -f --input-file -s --scenario --iteration-data-dataset --iteration-data-view -m --map-column -e --environment --working-dir --no-insecure-file-read --verbose --no-truncate --output --reporters -x --suppress-exit-code --workspace --verbose --debug --json -h --help" -- "$cur") )
523
542
  return 0
524
543
  fi
525
544
  case "$prev" in
@@ -529,6 +548,9 @@ _postman_flows_run() {
529
548
  -f|--input-file)
530
549
  _postman_filematch '!*.@(json)' "$cur"
531
550
  return 0 ;;
551
+ --iteration-data-dataset)
552
+ _postman_filematch '!*.@(json|csv)' "$cur"
553
+ return 0 ;;
532
554
  -e|--environment)
533
555
  _postman_filematch '!*.@(json)' "$cur"
534
556
  return 0 ;;
@@ -702,19 +724,22 @@ _postman_mock() {
702
724
  if [[ "$cur" == -* ]]; then
703
725
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
704
726
  else
705
- COMPREPLY=( $(compgen -W "generate run" -- "$cur") )
727
+ COMPREPLY=( $(compgen -W "generate run get list delete" -- "$cur") )
706
728
  fi
707
729
  return 0
708
730
  fi
709
731
  case "$subcmd" in
710
732
  generate) _postman_mock_generate ;;
711
733
  run) _postman_mock_run ;;
734
+ get) _postman_mock_get ;;
735
+ list) _postman_mock_list ;;
736
+ delete) _postman_mock_delete ;;
712
737
  esac
713
738
  }
714
739
 
715
740
  _postman_mock_generate() {
716
741
  if [[ "$cur" == -* ]]; then
717
- COMPREPLY=( $(compgen -W "-o --output --name --port --force -u --update -x --suppress-exit-code -h --help" -- "$cur") )
742
+ COMPREPLY=( $(compgen -W "-o --output -n --name --port --force -u --update -x --suppress-exit-code -h --help" -- "$cur") )
718
743
  return 0
719
744
  fi
720
745
  case "$prev" in
@@ -740,6 +765,31 @@ _postman_mock_run() {
740
765
  _postman_filematch '!*.@(json)' "$cur"
741
766
  return 0 ;;
742
767
  esac
768
+ _postman_filematch '!*.@(json)' "$cur"
769
+ }
770
+
771
+ _postman_mock_get() {
772
+ if [[ "$cur" == -* ]]; then
773
+ COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
774
+ return 0
775
+ fi
776
+ _postman_filematch '!*.@(json)' "$cur"
777
+ }
778
+
779
+ _postman_mock_list() {
780
+ if [[ "$cur" == -* ]]; then
781
+ COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
782
+ return 0
783
+ fi
784
+ _postman_filematch '!*.@(json)' "$cur"
785
+ }
786
+
787
+ _postman_mock_delete() {
788
+ if [[ "$cur" == -* ]]; then
789
+ COMPREPLY=( $(compgen -W "-y --yes -h --help" -- "$cur") )
790
+ return 0
791
+ fi
792
+ _postman_filematch '!*.@(json)' "$cur"
743
793
  }
744
794
 
745
795
  _postman_application() {
@@ -747,13 +797,14 @@ _postman_application() {
747
797
  if [[ "$cur" == -* ]]; then
748
798
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
749
799
  else
750
- COMPREPLY=( $(compgen -W "init test" -- "$cur") )
800
+ COMPREPLY=( $(compgen -W "init test setup-capture" -- "$cur") )
751
801
  fi
752
802
  return 0
753
803
  fi
754
804
  case "$subcmd" in
755
805
  init) _postman_application_init ;;
756
806
  test) _postman_application_test ;;
807
+ setup-capture) _postman_application_setup_capture ;;
757
808
  esac
758
809
  }
759
810
 
@@ -787,6 +838,18 @@ _postman_application_test() {
787
838
  esac
788
839
  }
789
840
 
841
+ _postman_application_setup_capture() {
842
+ if [[ "$cur" == -* ]]; then
843
+ COMPREPLY=( $(compgen -W "--config -h --help" -- "$cur") )
844
+ return 0
845
+ fi
846
+ case "$prev" in
847
+ --config)
848
+ _postman_filematch '!*.@(json)' "$cur"
849
+ return 0 ;;
850
+ esac
851
+ }
852
+
790
853
  _postman_simulate() {
791
854
  if [[ -z "$subcmd" ]]; then
792
855
  if [[ "$cur" == -* ]]; then
@@ -1066,7 +1129,7 @@ _postman_webhook() {
1066
1129
  if [[ "$cur" == -* ]]; then
1067
1130
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
1068
1131
  else
1069
- COMPREPLY=( $(compgen -W "create start pause list delete status requests forward" -- "$cur") )
1132
+ COMPREPLY=( $(compgen -W "create start pause list delete status requests scripts forward" -- "$cur") )
1070
1133
  fi
1071
1134
  return 0
1072
1135
  fi
@@ -1078,6 +1141,7 @@ _postman_webhook() {
1078
1141
  delete) _postman_webhook_delete ;;
1079
1142
  status) _postman_webhook_status ;;
1080
1143
  requests) _postman_webhook_requests ;;
1144
+ scripts) _postman_webhook_scripts ;;
1081
1145
  forward) _postman_webhook_forward ;;
1082
1146
  esac
1083
1147
  }
@@ -1184,7 +1248,7 @@ _postman_webhook_requests_list() {
1184
1248
 
1185
1249
  _postman_webhook_requests_describe() {
1186
1250
  if [[ "$cur" == -* ]]; then
1187
- COMPREPLY=( $(compgen -W "-w --workspace --api-key -h --help" -- "$cur") )
1251
+ COMPREPLY=( $(compgen -W "-w --workspace --api-key --verbose -h --help" -- "$cur") )
1188
1252
  return 0
1189
1253
  fi
1190
1254
  case "$prev" in
@@ -1206,6 +1270,32 @@ _postman_webhook_requests_replay() {
1206
1270
  esac
1207
1271
  }
1208
1272
 
1273
+ _postman_webhook_scripts() {
1274
+ if [[ -z "$subcmd" ]]; then
1275
+ if [[ "$cur" == -* ]]; then
1276
+ COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
1277
+ else
1278
+ COMPREPLY=( $(compgen -W "set" -- "$cur") )
1279
+ fi
1280
+ return 0
1281
+ fi
1282
+ case "$subcmd" in
1283
+ set) _postman_webhook_scripts_set ;;
1284
+ esac
1285
+ }
1286
+
1287
+ _postman_webhook_scripts_set() {
1288
+ if [[ "$cur" == -* ]]; then
1289
+ COMPREPLY=( $(compgen -W "--event -w --workspace --api-key -h --help" -- "$cur") )
1290
+ return 0
1291
+ fi
1292
+ case "$prev" in
1293
+ --api-key)
1294
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
1295
+ return 0 ;;
1296
+ esac
1297
+ }
1298
+
1209
1299
  _postman_webhook_forward() {
1210
1300
  if [[ "$cur" == -* ]]; then
1211
1301
  COMPREPLY=( $(compgen -W "-w --workspace --api-key -h --help" -- "$cur") )
@@ -1265,7 +1355,7 @@ _postman_dataset_get() {
1265
1355
 
1266
1356
  _postman_dataset_query() {
1267
1357
  if [[ "$cur" == -* ]]; then
1268
- COMPREPLY=( $(compgen -W "-q --query -p --param --api-key --json -h --help" -- "$cur") )
1358
+ COMPREPLY=( $(compgen -W "-q --query -p --param --api-key --json --debug -h --help" -- "$cur") )
1269
1359
  return 0
1270
1360
  fi
1271
1361
  case "$prev" in
@@ -1331,13 +1421,19 @@ _postman_dataset_source_list() {
1331
1421
 
1332
1422
  _postman_dataset_source_add() {
1333
1423
  if [[ "$cur" == -* ]]; then
1334
- COMPREPLY=( $(compgen -W "-d --dataset -n --name --source-id --format --type --file --ref-only --force --upload --url --host --port --user --password --database --table --slug --api-key -h --help" -- "$cur") )
1424
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name --source-id --format --type --file --ref-only --force --upload --host --port --user --password --database --table --ssh-host --ssh-port --ssh-user --ssh-private-key --ssh-host-key --ssh-host-key-vault-id --ssh-host-key-secret-id --ssh-insecure-skip-host-key-verification --schema --encrypt --trust-server-certificate --tls-certificate --host-name-in-certificate --tls-min-version --api-key -h --help" -- "$cur") )
1335
1425
  return 0
1336
1426
  fi
1337
1427
  case "$prev" in
1338
1428
  --file)
1339
1429
  _postman_filematch '!*.@(json)' "$cur"
1340
1430
  return 0 ;;
1431
+ --ssh-private-key)
1432
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
1433
+ return 0 ;;
1434
+ --tls-certificate)
1435
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
1436
+ return 0 ;;
1341
1437
  --api-key)
1342
1438
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1343
1439
  return 0 ;;
@@ -1358,13 +1454,19 @@ _postman_dataset_source_remove() {
1358
1454
 
1359
1455
  _postman_dataset_source_update() {
1360
1456
  if [[ "$cur" == -* ]]; then
1361
- COMPREPLY=( $(compgen -W "-d --dataset -n --name --format --file --ref-only --force --url --host --port --user --password --database --table --slug --api-key -h --help" -- "$cur") )
1457
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name --format --file --ref-only --force --host --port --user --password --database --table --ssh-host --ssh-port --ssh-user --ssh-private-key --ssh-host-key --ssh-host-key-vault-id --ssh-host-key-secret-id --ssh-insecure-skip-host-key-verification --schema --encrypt --trust-server-certificate --tls-certificate --host-name-in-certificate --tls-min-version --api-key -h --help" -- "$cur") )
1362
1458
  return 0
1363
1459
  fi
1364
1460
  case "$prev" in
1365
1461
  --file)
1366
1462
  _postman_filematch '!*.@(json)' "$cur"
1367
1463
  return 0 ;;
1464
+ --ssh-private-key)
1465
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
1466
+ return 0 ;;
1467
+ --tls-certificate)
1468
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
1469
+ return 0 ;;
1368
1470
  --api-key)
1369
1471
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1370
1472
  return 0 ;;
@@ -1403,7 +1505,7 @@ _postman_dataset_view_list() {
1403
1505
 
1404
1506
  _postman_dataset_view_run() {
1405
1507
  if [[ "$cur" == -* ]]; then
1406
- COMPREPLY=( $(compgen -W "-d --dataset -p --param --api-key --json -h --help" -- "$cur") )
1508
+ COMPREPLY=( $(compgen -W "-d --dataset -p --param --api-key --json --debug -h --help" -- "$cur") )
1407
1509
  return 0
1408
1510
  fi
1409
1511
  case "$prev" in
@@ -1,4 +1,4 @@
1
- # Fish completion for Postman CLI (postman v1.48.0)
1
+ # Fish completion for Postman CLI (postman v1.51.0)
2
2
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
3
3
  # Source: spec/commands.json
4
4
  # https://github.com/yokawasa/postman-cli-completion
@@ -44,7 +44,7 @@ complete -c postman -n __postman_no_subcommand -a simulate -d 'Start mock server
44
44
  complete -c postman -n __postman_no_subcommand -a context -d '[Beta] Get API context for AI coding agents directly from the command line.'
45
45
  complete -c postman -n __postman_no_subcommand -a search -d 'Search for Postman element types (requests, collections, workspaces, and more).'
46
46
  complete -c postman -n __postman_no_subcommand -a webhook -d 'Create and manage Postman webhooks.'
47
- complete -c postman -n __postman_no_subcommand -a dataset -d '[BETA] Work with Postman datasets defined in local YAML files.'
47
+ complete -c postman -n __postman_no_subcommand -a dataset -d '[BETA] Work with Postman datasets in local YAML files or the cloud.'
48
48
 
49
49
  # ---------- login ----------
50
50
  complete -c postman -n '__fish_seen_subcommand_from login' -l alias -d 'Specify the alias of the API key to fetch your resources using it. (This option is discontinued and will be removed in a future release.)' -x
@@ -208,10 +208,12 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
208
208
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
209
209
 
210
210
  # ---------- workspace ----------
211
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint' -a list -d 'List all available Postman Workspaces'
212
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
213
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint' -a push -d 'Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
214
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint' -a lint -d 'Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
211
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a list -d 'List all available Postman Workspaces'
212
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
213
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a push -d 'Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
214
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a lint -d 'Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
215
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a pull -d 'Pull workspace entities from a Postman workspace into the local git-native folder.'
216
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a connect-git -d 'Connect a Postman workspace to a local git repository.'
215
217
  complete -c postman -n '__fish_seen_subcommand_from workspace' -s h -l help -d 'display help for command'
216
218
  # ---------- workspace list ----------
217
219
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -s f -l filter -d 'Filter workspaces by name.' -x
@@ -235,7 +237,17 @@ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_s
235
237
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s o -l output -d 'Output format: cli (human-readable), table, or json. (default: "cli")' -x
236
238
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -l meta -d 'Only lint the workspace configuration (.postman/resources.yaml); skip per-entity linting.'
237
239
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -l workspace-id -d 'The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.' -x
240
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -l fix -d 'Apply safe autofixes to repairable workspace lint issues.'
238
241
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
242
+ # ---------- workspace pull ----------
243
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -s y -l yes -d 'Skip all confirmation prompts'
244
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -l source-workspace -d 'Pull from a different source workspace.' -x
245
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -l verbose -d 'Show detailed logging'
246
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -s h -l help -d 'display help for command'
247
+ # ---------- workspace connect-git ----------
248
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -l verbose -d 'Show detailed logging'
249
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -s h -l help -d 'display help for command'
250
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -r -k -a '(__fish_complete_suffix .json)'
239
251
 
240
252
  # ---------- performance ----------
241
253
  complete -c postman -n '__postman_using_subcommand performance run' -a run -d 'Run a performance test on a collection'
@@ -247,7 +259,11 @@ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen
247
259
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s d -l duration -d 'Duration of the performance test in minutes (default: 1)' -x
248
260
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s p -l load-profile -d 'Load profile type: fixed, ramp-up, spike, peak (default: "ramp-up")' -x
249
261
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l data-file -d 'Path to a JSON or CSV data file to use with the collection' -r
262
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l dataset-id -d 'Use a Postman Dataset as iteration data (with --dataset-view-id)' -x
263
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l dataset-view-id -d 'Dataset view to execute for iteration data (requires --dataset-id)' -x
264
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l dataset-distribution -d 'How rows map to VUs: round-robin (default), fixed, random' -x
250
265
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l postman-api-key -d 'API Key used to load the resources from the Postman API (Only supported in the US region, use \'postman login --region\' to authenticate instead)' -x
266
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l runner -d 'Runner to execute the performance test on (local or postman-cloud) (default: local)' -x
251
267
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l pass-if -d 'Pass condition in format: function(metric, value). Functions: less_than, greater_than, less_than_eq, greater_than_eq. Metrics: avg, p90, p95, p99, error_rate, rps. Example: less_than(p95, 500) or less_than(error_rate, 5)' -x
252
268
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
253
269
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
@@ -295,8 +311,12 @@ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subco
295
311
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s i -l input -d 'Set flow inputs as key=value pairs (e.g. --input foo=bar --input baz=qux) (default: [])' -r
296
312
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s f -l input-file -d 'Set flow inputs from JSON files (e.g. --input-file ./inputs.json --input-file ./config.json) (default: [])' -r
297
313
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s s -l scenario -d 'Use a pre-built scenario as flow inputs (by scenario name). Can be combined with --input and --input-file to override values.' -x
314
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l iteration-data-dataset -d '[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).' -r
315
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l iteration-data-view -d '[BETA] Name or id of the view (within --iteration-data-dataset) whose rows drive the run.' -x
316
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s m -l map-column -d '[BETA] Bind a flow input to a dataset column (e.g. -m isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default: [])' -x
298
317
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s e -l environment -d 'Specify a path to a Postman Environment file (JSON or YAML)' -r
299
318
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l working-dir -d 'Specify the path to the working directory' -x
319
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l no-insecure-file-read -d 'Prevent reading dataset files situated outside of the working directory (applies to --iteration-data-dataset)'
300
320
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l verbose -d 'Show detailed information of flow run and each request (method, URL, assertions)'
301
321
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l no-truncate -d 'Show full output without truncating long values'
302
322
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l output -d 'Save execution result to a file (supported: json)' -x
@@ -454,12 +474,15 @@ complete -c postman -n '__fish_seen_subcommand_from sdk; and __fish_seen_subcomm
454
474
  complete -c postman -n '__fish_seen_subcommand_from sdk; and __fish_seen_subcommand_from connections; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
455
475
 
456
476
  # ---------- mock ----------
457
- complete -c postman -n '__postman_using_subcommand mock generate run' -a generate -d 'Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected.'
458
- complete -c postman -n '__postman_using_subcommand mock generate run' -a run -d 'Start a local mock server given a manifest file (JSON or YAML).'
477
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a generate -d 'Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample mock with a GET /health endpoint.'
478
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a run -d 'Start a local mock server given a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
479
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a get -d 'Show a local mock\'s details and run status.'
480
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a list -d 'List local mocks found under a directory.'
481
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a delete -d 'Permanently remove a local mock artifact.'
459
482
  complete -c postman -n '__fish_seen_subcommand_from mock' -s h -l help -d 'display help for command'
460
483
  # ---------- mock generate ----------
461
484
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s o -l output -d 'Output directory for the mock (default: postman/mocks/<slug>)' -r
462
- complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l name -d 'Display name for the generated mock' -x
485
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s n -l name -d 'Display name for the generated mock. Optional with a source (derived from it); required when generating without a source.' -x
463
486
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l port -d 'Port the mock server should listen on (default: 4500)' -x
464
487
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l force -d 'Overwrite the config.yaml/default.js in the output directory if it already exists'
465
488
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s u -l update -d 'Update an existing mock in place from the source: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port/scenarios. Cannot be combined with --output.' -r
@@ -470,10 +493,24 @@ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcom
470
493
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s g -l globals -d 'Path to a globals file (JSON or YAML) for pm.globals' -r
471
494
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s p -l port -d 'Mock server port, or "auto" for an ephemeral one (default: configured port, falls back to an ephemeral one if busy).' -x
472
495
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
496
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
497
+ # ---------- mock get ----------
498
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -l json -d 'Output the mock details as JSON instead of a table'
499
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
500
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
501
+ # ---------- mock list ----------
502
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -l json -d 'Output the mock list as JSON instead of a table'
503
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
504
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
505
+ # ---------- mock delete ----------
506
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
507
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
508
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -r -k -a '(__fish_complete_suffix .json)'
473
509
 
474
510
  # ---------- application ----------
475
- complete -c postman -n '__postman_using_subcommand application init test' -a init -d 'Initialise a postman.config.cjs file with target collections, environment, and test command.'
476
- complete -c postman -n '__postman_using_subcommand application init test' -a test -d 'Run a command first (primary task), then match captured traffic against Postman collections and run assertions.'
511
+ complete -c postman -n '__postman_using_subcommand application init test setup-capture' -a init -d '[DEPRECATED] Use `postman app test` instead. Initialise a postman.config.cjs file with target collections, environment, and test command.'
512
+ complete -c postman -n '__postman_using_subcommand application init test setup-capture' -a test -d 'Run a command first (primary task), then match captured traffic against Postman collections and run assertions.'
513
+ complete -c postman -n '__postman_using_subcommand application init test setup-capture' -a setup-capture -d 'Install postman-playwright and patch playwright.config.* to capture network traffic automatically via withPostman().'
477
514
  complete -c postman -n '__fish_seen_subcommand_from application' -s h -l help -d 'display help for command'
478
515
  # ---------- application init ----------
479
516
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from init' -l target-collection -d 'Collection name or path for the default target (repeatable) (default: [])' -x
@@ -496,6 +533,9 @@ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen
496
533
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l report-events -d 'Send application test run results and analytics to Postman'
497
534
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l verbose -d 'Show detailed per-request matching, sandbox errors, and debug information'
498
535
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -s h -l help -d 'display help for command'
536
+ # ---------- application setup-capture ----------
537
+ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from setup-capture' -l config -d 'Path to playwright.config.* to patch (default: auto-detect)' -r
538
+ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from setup-capture' -s h -l help -d 'display help for command'
499
539
 
500
540
  # ---------- simulate ----------
501
541
  complete -c postman -n '__postman_using_subcommand simulate run' -a run -d 'Start mocks with fault-injection scenarios defined in a .sim.yaml file'
@@ -595,14 +635,15 @@ complete -c postman -n '__fish_seen_subcommand_from search; and __fish_seen_subc
595
635
  complete -c postman -n '__fish_seen_subcommand_from search; and __fish_seen_subcommand_from documents' -s h -l help -d 'display help for command'
596
636
 
597
637
  # ---------- webhook ----------
598
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a create -d 'Create a new webhook and print its public URL.'
599
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a start -d 'Activate a webhook so it can receive requests.'
600
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a pause -d 'Pause a webhook so it no longer accepts requests.'
601
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a list -d 'List all webhooks in a workspace.'
602
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a delete -d 'Permanently delete a webhook.'
603
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a status -d 'Show details for a webhook.'
604
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a requests -d 'List, inspect, and replay requests received by a webhook.'
605
- complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests forward' -a forward -d 'Forward incoming webhook requests to a local port.'
638
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a create -d 'Create a new webhook and print its public URL.'
639
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a start -d 'Activate a webhook so it can receive requests.'
640
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a pause -d 'Pause a webhook so it no longer accepts requests.'
641
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a list -d 'List all webhooks in a workspace.'
642
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a delete -d 'Permanently delete a webhook.'
643
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a status -d 'Show details for a webhook.'
644
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a requests -d 'List, inspect, and replay requests received by a webhook.'
645
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a scripts -d 'Create or update scripts executed by a webhook.'
646
+ complete -c postman -n '__postman_using_subcommand webhook create start pause list delete status requests scripts forward' -a forward -d 'Forward incoming webhook requests to a local port.'
606
647
  complete -c postman -n '__fish_seen_subcommand_from webhook' -s h -l help -d 'display help for command'
607
648
  # ---------- webhook create ----------
608
649
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from create' -s t -l title -d 'Name for the webhook (default: "CLI Webhook")' -x
@@ -642,11 +683,20 @@ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_sub
642
683
  # ---------- webhook requests describe ----------
643
684
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from describe' -s w -l workspace -d 'Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)' -x
644
685
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from describe' -l api-key -d 'Postman API key' -r
686
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from describe' -l verbose -d 'Show script execution logs'
645
687
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from describe' -s h -l help -d 'display help for command'
646
688
  # ---------- webhook requests replay ----------
647
689
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from replay' -s w -l workspace -d 'Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)' -x
648
690
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from replay' -l api-key -d 'Postman API key' -r
649
691
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from requests; and __fish_seen_subcommand_from replay' -s h -l help -d 'display help for command'
692
+ # ---------- webhook scripts ----------
693
+ complete -c postman -n '__postman_using_subcommand scripts set' -a set -d 'Create or update a webhook script from a JavaScript or TypeScript file.'
694
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from scripts' -s h -l help -d 'display help for command'
695
+ # ---------- webhook scripts set ----------
696
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from scripts; and __fish_seen_subcommand_from set' -l event -d 'Script event: onEvent or onResponse' -x
697
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from scripts; and __fish_seen_subcommand_from set' -s w -l workspace -d 'Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)' -x
698
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from scripts; and __fish_seen_subcommand_from set' -l api-key -d 'Postman API key' -r
699
+ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from scripts; and __fish_seen_subcommand_from set' -s h -l help -d 'display help for command'
650
700
  # ---------- webhook forward ----------
651
701
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from forward' -s w -l workspace -d 'Postman workspace ID' -x
652
702
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from forward' -l api-key -d 'Postman API key' -r
@@ -657,7 +707,7 @@ complete -c postman -n '__postman_using_subcommand dataset list get query create
657
707
  complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a get -d '[BETA] Print a dataset\'s metadata and structure summary (local YAML path or cloud id).'
658
708
  complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a query -d '[BETA] Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
659
709
  complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a create -d '[BETA] Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
660
- complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a delete -d '[BETA] Permanently remove a dataset: a local .dataset.yaml (+ .resources/) or a cloud dataset id.'
710
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a delete -d '[BETA] Permanently remove a dataset: a local .dataset.yaml or a cloud dataset id.'
661
711
  complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a source -d '[BETA] Inspect and manage a dataset\'s datasources.'
662
712
  complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a view -d '[BETA] Inspect and manage saved views on a dataset.'
663
713
  complete -c postman -n '__fish_seen_subcommand_from dataset' -s h -l help -d 'display help for command'
@@ -674,9 +724,10 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
674
724
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
675
725
  # ---------- dataset query ----------
676
726
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s q -l query -d 'SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")' -x
677
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s p -l param -d 'Positional parameter values for $1, $2, ... bindings; repeatable' -x
727
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s p -l param -d 'Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p' -x
678
728
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
679
729
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l json -d 'Output rows as JSON instead of a table'
730
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l debug -d 'Include safe classified dataset diagnostics'
680
731
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s h -l help -d 'display help for command'
681
732
  # ---------- dataset create ----------
682
733
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -s n -l name -d 'Human-readable name for the dataset' -x
@@ -689,7 +740,7 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
689
740
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -r -k -a '(__fish_complete_suffix .json)'
690
741
  # ---------- dataset delete ----------
691
742
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
692
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -l keep-resources -d 'Delete only the YAML file; leave the .resources/ directory intact (local only)'
743
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -l keep-resources -d 'Preserve the local resource directory even when it is empty (local only)'
693
744
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
694
745
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
695
746
  # ---------- dataset source ----------
@@ -704,23 +755,35 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
704
755
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -l json -d 'Output sources as JSON instead of a table'
705
756
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
706
757
  # ---------- dataset source add ----------
707
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s d -l dataset -d 'Dataset to add the source to — a local .dataset.yaml path or a cloud dataset id' -x
758
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s d -l dataset -d 'Dataset to add the source to; positional target is also accepted for v1.45 compatibility' -x
708
759
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s n -l name -d 'Logical name for the source (becomes the SQL table name)' -x
709
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l source-id -d 'Override the generated source id' -x
710
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l format -d 'Override the inferred format' -x
711
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l type -d 'Source kind; inferred from --file/--url when omitted' -x
760
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l source-id -d 'Override the generated source id (local dataset only)' -x
761
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l format -d 'Use this format instead of extension/type inference; file contents are not sniffed' -x
762
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l type -d 'Source kind; local is inferred when --file is provided' -x
712
763
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l file -d 'Path to a local CSV/JSON file (absolute or cwd-relative)' -r
713
764
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ref-only -d 'Reference the file in place; do NOT copy into data_dir (local dataset)'
714
765
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l force -d 'When copying, overwrite an existing file at the destination (local dataset)'
715
766
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l upload -d 'Cloud dataset only: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem csv/json source read by the local engine.'
716
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l url -d 'HTTP(S) URL to a remote CSV/JSON file' -x
717
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l host -d 'DB host (mysql/postgresql)' -x
718
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l port -d 'DB port' -x
767
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l host -d 'DB host (mysql/postgresql/sqlserver)' -x
768
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l port -d 'DB port (defaults to 1433 for sqlserver)' -x
719
769
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l user -d 'DB user (warning: stored as plaintext in the YAML).' -x
720
770
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l password -d 'DB password. WARNING: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.' -x
721
771
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l database -d 'DB database name' -x
722
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l table -d 'DB table name (optional)' -x
723
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l slug -d 'Optional slug for the source' -x
772
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l table -d 'DB table name (required for sqlserver)' -x
773
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-host -d 'SSH bastion host' -x
774
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-port -d 'SSH bastion port' -x
775
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-user -d 'SSH bastion user' -x
776
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-private-key -d 'Path to the SSH private key. WARNING: the path is visible in `ps` output and shell history; key contents are read locally at execution time and are not stored in the dataset config.' -r
777
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-host-key -d 'SSH bastion public host key' -x
778
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-host-key-vault-id -d 'Shared Vault ID containing the SSH public host key' -x
779
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-host-key-secret-id -d 'Shared Vault secret ID containing the SSH public host key' -x
780
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-insecure-skip-host-key-verification -d 'WARNING: disable SSH host-key verification; use only for trusted local testing'
781
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l schema -d 'DB schema (postgresql/sqlserver; defaults to dbo for sqlserver)' -x
782
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l encrypt -d 'SQL Server TLS encryption (default: true)' -x
783
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l trust-server-certificate -d 'SQL Server: skip certificate verification (default: false; insecure)' -x
784
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l tls-certificate -d 'SQL Server CA/server certificate file path' -r
785
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l host-name-in-certificate -d 'SQL Server certificate hostname override' -x
786
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l tls-min-version -d 'SQL Server minimum TLS version (default: 1.2)' -x
724
787
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
725
788
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s h -l help -d 'display help for command'
726
789
  # ---------- dataset source remove ----------
@@ -730,18 +793,30 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
730
793
  # ---------- dataset source update ----------
731
794
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s d -l dataset -d 'Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id' -x
732
795
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s n -l name -d 'Rename the source' -x
733
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l format -d 'Change the format' -x
734
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l file -d 'Replace the source\'s file (local-filesystem only)' -r
735
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ref-only -d 'When using --file, reference in place instead of copying'
736
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l force -d 'When copying with --file, overwrite existing destination'
737
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l url -d 'Replace the remote URL (remote-url only)' -x
738
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l host -d 'Update DB host (mysql/postgresql)' -x
796
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l format -d 'Change the format (local dataset only; cloud source formats are immutable)' -x
797
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l file -d 'Replace the source file (local dataset only; cloud file replacement is unsupported)' -r
798
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ref-only -d 'With --file, reference in place instead of copying (local dataset only)'
799
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l force -d 'With --file, overwrite the copied destination (local dataset only)'
800
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l host -d 'Update DB host (mysql/postgresql/sqlserver)' -x
739
801
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l port -d 'Update DB port' -x
740
802
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l user -d 'Update DB user (warning: stored as plaintext in the YAML).' -x
741
803
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l password -d 'Update DB password. WARNING: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.' -x
742
804
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l database -d 'Update DB database name' -x
743
805
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l table -d 'Update DB table name' -x
744
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l slug -d 'Update slug' -x
806
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-host -d 'Update SSH bastion host' -x
807
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-port -d 'Update SSH bastion port' -x
808
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-user -d 'Update SSH bastion user' -x
809
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-private-key -d 'Update the SSH private-key file path. WARNING: the path is visible in `ps` output and shell history; key contents are read locally and are not stored in the dataset config.' -r
810
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-host-key -d 'Update the SSH bastion public host key' -x
811
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-host-key-vault-id -d 'Update the Shared Vault ID containing the SSH public host key' -x
812
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-host-key-secret-id -d 'Update the Shared Vault secret ID containing the SSH public host key' -x
813
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-insecure-skip-host-key-verification -d 'WARNING: disable SSH host-key verification; use only for trusted local testing'
814
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l schema -d 'Update DB schema (postgresql/sqlserver)' -x
815
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l encrypt -d 'Update SQL Server TLS encryption' -x
816
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l trust-server-certificate -d 'Update SQL Server certificate verification (true is insecure)' -x
817
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l tls-certificate -d 'Update SQL Server CA/server certificate file path' -r
818
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l host-name-in-certificate -d 'Update SQL Server certificate hostname override' -x
819
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l tls-min-version -d 'Update SQL Server minimum TLS version' -x
745
820
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
746
821
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
747
822
  # ---------- dataset view ----------
@@ -758,9 +833,10 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
758
833
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
759
834
  # ---------- dataset view run ----------
760
835
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s d -l dataset -d 'Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id' -x
761
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s p -l param -d 'Positional parameter values for $1, $2, ... bindings; repeatable' -x
836
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s p -l param -d 'Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p' -x
762
837
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
763
838
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -l json -d 'Output rows as JSON instead of a table'
839
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -l debug -d 'Include safe classified dataset diagnostics'
764
840
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
765
841
  # ---------- dataset view create ----------
766
842
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -s d -l dataset -d 'Dataset to add the view to — a local .dataset.yaml path or a cloud dataset id' -x
@@ -1,6 +1,6 @@
1
1
  #compdef postman
2
2
  compdef _postman postman
3
- # Zsh completion for Postman CLI (postman v1.48.0)
3
+ # Zsh completion for Postman CLI (postman v1.51.0)
4
4
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
5
5
  # Source: spec/commands.json
6
6
  # https://github.com/yokawasa/postman-cli-completion
@@ -72,7 +72,7 @@ _postman_commands() {
72
72
  'context:\[Beta\] Get API context for AI coding agents directly from the command line.'
73
73
  'search:Search for Postman element types (requests, collections, workspaces, and more).'
74
74
  'webhook:Create and manage Postman webhooks.'
75
- 'dataset:\[BETA\] Work with Postman datasets defined in local YAML files.'
75
+ 'dataset:\[BETA\] Work with Postman datasets in local YAML files or the cloud.'
76
76
  )
77
77
  _describe -t commands 'postman command' commands
78
78
  }
@@ -442,6 +442,8 @@ _postman_workspace() {
442
442
  prepare) _postman_workspace_prepare ;;
443
443
  push) _postman_workspace_push ;;
444
444
  lint) _postman_workspace_lint ;;
445
+ pull) _postman_workspace_pull ;;
446
+ connect-git) _postman_workspace_connect_git ;;
445
447
  esac
446
448
  ;;
447
449
  esac
@@ -454,6 +456,8 @@ _postman_workspace_commands() {
454
456
  'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
455
457
  'push:Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
456
458
  'lint:Lint the current local Postman workspace\: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
459
+ 'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
460
+ 'connect-git:Connect a Postman workspace to a local git repository.'
457
461
  )
458
462
  _describe -t commands 'workspace command' sub
459
463
  }
@@ -490,9 +494,26 @@ _postman_workspace_lint() {
490
494
  '(-o --output)'{-o,--output}'[Output format\: cli (human-readable), table, or json. (default\: "cli")]:value' \
491
495
  '--meta[Only lint the workspace configuration (.postman/resources.yaml); skip per-entity linting.]' \
492
496
  '--workspace-id[The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.]:value' \
497
+ '--fix[Apply safe autofixes to repairable workspace lint issues.]' \
493
498
  '(-h --help)'{-h,--help}'[display help for command]'
494
499
  }
495
500
 
501
+ _postman_workspace_pull() {
502
+ _arguments \
503
+ '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
504
+ '--source-workspace[Pull from a different source workspace.]:workspaceId' \
505
+ '--verbose[Show detailed logging]' \
506
+ '(-h --help)'{-h,--help}'[display help for command]' \
507
+ '*:workspaceId:'
508
+ }
509
+
510
+ _postman_workspace_connect_git() {
511
+ _arguments \
512
+ '--verbose[Show detailed logging]' \
513
+ '(-h --help)'{-h,--help}'[display help for command]' \
514
+ '*:path:_files -g "*.json"'
515
+ }
516
+
496
517
  _postman_performance() {
497
518
  local context state state_descr line
498
519
  typeset -A opt_args
@@ -525,7 +546,11 @@ _postman_performance_run() {
525
546
  '(-d --duration)'{-d,--duration}'[Duration of the performance test in minutes (default\: 1)]:minutes' \
526
547
  '(-p --load-profile)'{-p,--load-profile}'[Load profile type\: fixed, ramp-up, spike, peak (default\: "ramp-up")]:profile' \
527
548
  '--data-file[Path to a JSON or CSV data file to use with the collection]:path:_files -g "*.json"' \
549
+ '--dataset-id[Use a Postman Dataset as iteration data (with --dataset-view-id)]:id' \
550
+ '--dataset-view-id[Dataset view to execute for iteration data (requires --dataset-id)]:id' \
551
+ '--dataset-distribution[How rows map to VUs\: round-robin (default), fixed, random]:strategy' \
528
552
  '--postman-api-key[API Key used to load the resources from the Postman API (Only supported in the US region, use '\''postman login --region'\'' to authenticate instead)]:apiKey' \
553
+ '--runner[Runner to execute the performance test on (local or postman-cloud) (default\: local)]:runner' \
529
554
  '--pass-if[Pass condition in format\: function(metric, value). Functions\: less_than, greater_than, less_than_eq, greater_than_eq. Metrics\: avg, p90, p95, p99, error_rate, rps. Example\: less_than(p95, 500) or less_than(error_rate, 5)]:condition' \
530
555
  '(-h --help)'{-h,--help}'[display help for command]' \
531
556
  '*:collectionId:_files -g "*.json"'
@@ -613,8 +638,12 @@ _postman_flows_run() {
613
638
  '(-i --input)'{-i,--input}'[Set flow inputs as key=value pairs (e.g. --input foo=bar --input baz=qux) (default\: \[\])]:key=value:_files -g "*.(pem|crt|key)"' \
614
639
  '(-f --input-file)'{-f,--input-file}'[Set flow inputs from JSON files (e.g. --input-file ./inputs.json --input-file ./config.json) (default\: \[\])]:path.json:_files -g "*.json"' \
615
640
  '(-s --scenario)'{-s,--scenario}'[Use a pre-built scenario as flow inputs (by scenario name). Can be combined with --input and --input-file to override values.]:name' \
641
+ '--iteration-data-dataset[\[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).]:pathOrId:_files -g "*.(json|csv)"' \
642
+ '--iteration-data-view[\[BETA\] Name or id of the view (within --iteration-data-dataset) whose rows drive the run.]:nameOrId' \
643
+ '(-m --map-column)'{-m,--map-column}'[\[BETA\] Bind a flow input to a dataset column (e.g. -m isActive=active). Repeatable. Inputs whose name matches a column bind automatically. (default\: \[\])]:input=column' \
616
644
  '(-e --environment)'{-e,--environment}'[Specify a path to a Postman Environment file (JSON or YAML)]:path:_files -g "*.json"' \
617
645
  '--working-dir[Specify the path to the working directory]:path:_files -/' \
646
+ '--no-insecure-file-read[Prevent reading dataset files situated outside of the working directory (applies to --iteration-data-dataset)]' \
618
647
  '--verbose[Show detailed information of flow run and each request (method, URL, assertions)]' \
619
648
  '--no-truncate[Show full output without truncating long values]' \
620
649
  '--output[Save execution result to a file (supported\: json)]:format' \
@@ -875,6 +904,9 @@ _postman_mock() {
875
904
  case $words[1] in
876
905
  generate) _postman_mock_generate ;;
877
906
  run) _postman_mock_run ;;
907
+ get) _postman_mock_get ;;
908
+ list) _postman_mock_list ;;
909
+ delete) _postman_mock_delete ;;
878
910
  esac
879
911
  ;;
880
912
  esac
@@ -883,8 +915,11 @@ _postman_mock() {
883
915
  _postman_mock_commands() {
884
916
  local -a sub
885
917
  sub=(
886
- 'generate:Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected.'
887
- 'run:Start a local mock server given a manifest file (JSON or YAML).'
918
+ 'generate:Generate a local, runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample mock with a GET /health endpoint.'
919
+ 'run:Start a local mock server given a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
920
+ 'get:Show a local mock'\''s details and run status.'
921
+ 'list:List local mocks found under a directory.'
922
+ 'delete:Permanently remove a local mock artifact.'
888
923
  )
889
924
  _describe -t commands 'mock command' sub
890
925
  }
@@ -892,7 +927,7 @@ _postman_mock_commands() {
892
927
  _postman_mock_generate() {
893
928
  _arguments \
894
929
  '(-o --output)'{-o,--output}'[Output directory for the mock (default\: postman/mocks/<slug>)]:dir:_files -g "*.json"' \
895
- '--name[Display name for the generated mock]:name' \
930
+ '(-n --name)'{-n,--name}'[Display name for the generated mock. Optional with a source (derived from it); required when generating without a source.]:name' \
896
931
  '--port[Port the mock server should listen on (default\: 4500)]:port' \
897
932
  '--force[Overwrite the config.yaml/default.js in the output directory if it already exists]' \
898
933
  '(-u --update)'{-u,--update}'[Update an existing mock in place from the source\: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port/scenarios. Cannot be combined with --output.]:mockPath:_files -g "*.json"' \
@@ -907,7 +942,28 @@ _postman_mock_run() {
907
942
  '(-g --globals)'{-g,--globals}'[Path to a globals file (JSON or YAML) for pm.globals]:path:_files -g "*.json"' \
908
943
  '(-p --port)'{-p,--port}'[Mock server port, or "auto" for an ephemeral one (default\: configured port, falls back to an ephemeral one if busy).]:port' \
909
944
  '(-h --help)'{-h,--help}'[display help for command]' \
910
- '*:manifestPath:'
945
+ '*:pathOrDir:_files -g "*.json"'
946
+ }
947
+
948
+ _postman_mock_get() {
949
+ _arguments \
950
+ '--json[Output the mock details as JSON instead of a table]' \
951
+ '(-h --help)'{-h,--help}'[display help for command]' \
952
+ '*:pathOrDir:_files -g "*.json"'
953
+ }
954
+
955
+ _postman_mock_list() {
956
+ _arguments \
957
+ '--json[Output the mock list as JSON instead of a table]' \
958
+ '(-h --help)'{-h,--help}'[display help for command]' \
959
+ '*:pathOrDir:_files -g "*.json"'
960
+ }
961
+
962
+ _postman_mock_delete() {
963
+ _arguments \
964
+ '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
965
+ '(-h --help)'{-h,--help}'[display help for command]' \
966
+ '*:pathOrDir:_files -g "*.json"'
911
967
  }
912
968
 
913
969
  _postman_application() {
@@ -922,6 +978,7 @@ _postman_application() {
922
978
  case $words[1] in
923
979
  init) _postman_application_init ;;
924
980
  test) _postman_application_test ;;
981
+ setup-capture) _postman_application_setup_capture ;;
925
982
  esac
926
983
  ;;
927
984
  esac
@@ -930,8 +987,9 @@ _postman_application() {
930
987
  _postman_application_commands() {
931
988
  local -a sub
932
989
  sub=(
933
- 'init:Initialise a postman.config.cjs file with target collections, environment, and test command.'
990
+ 'init:\[DEPRECATED\] Use `postman app test` instead. Initialise a postman.config.cjs file with target collections, environment, and test command.'
934
991
  'test:Run a command first (primary task), then match captured traffic against Postman collections and run assertions.'
992
+ 'setup-capture:Install postman-playwright and patch playwright.config.* to capture network traffic automatically via withPostman().'
935
993
  )
936
994
  _describe -t commands 'application command' sub
937
995
  }
@@ -963,6 +1021,12 @@ _postman_application_test() {
963
1021
  '(-h --help)'{-h,--help}'[display help for command]'
964
1022
  }
965
1023
 
1024
+ _postman_application_setup_capture() {
1025
+ _arguments \
1026
+ '--config[Path to playwright.config.* to patch (default\: auto-detect)]:path:_files -g "*.json"' \
1027
+ '(-h --help)'{-h,--help}'[display help for command]'
1028
+ }
1029
+
966
1030
  _postman_simulate() {
967
1031
  local context state state_descr line
968
1032
  typeset -A opt_args
@@ -1337,6 +1401,7 @@ _postman_webhook() {
1337
1401
  delete) _postman_webhook_delete ;;
1338
1402
  status) _postman_webhook_status ;;
1339
1403
  requests) _postman_webhook_requests ;;
1404
+ scripts) _postman_webhook_scripts ;;
1340
1405
  forward) _postman_webhook_forward ;;
1341
1406
  esac
1342
1407
  ;;
@@ -1353,6 +1418,7 @@ _postman_webhook_commands() {
1353
1418
  'delete:Permanently delete a webhook.'
1354
1419
  'status:Show details for a webhook.'
1355
1420
  'requests:List, inspect, and replay requests received by a webhook.'
1421
+ 'scripts:Create or update scripts executed by a webhook.'
1356
1422
  'forward:Forward incoming webhook requests to a local port.'
1357
1423
  )
1358
1424
  _describe -t commands 'webhook command' sub
@@ -1446,6 +1512,7 @@ _postman_webhook_requests_describe() {
1446
1512
  _arguments \
1447
1513
  '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)]:workspaceId' \
1448
1514
  '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
1515
+ '--verbose[Show script execution logs]' \
1449
1516
  '(-h --help)'{-h,--help}'[display help for command]' \
1450
1517
  '*:requestId:'
1451
1518
  }
@@ -1458,6 +1525,39 @@ _postman_webhook_requests_replay() {
1458
1525
  '*:requestId:'
1459
1526
  }
1460
1527
 
1528
+ _postman_webhook_scripts() {
1529
+ local context state state_descr line
1530
+ typeset -A opt_args
1531
+ _arguments -C \
1532
+ '(-h --help)'{-h,--help}'[display help for command]' \
1533
+ '1: :_postman_webhook_scripts_commands' \
1534
+ '*::arg:->args'
1535
+ case $state in
1536
+ args)
1537
+ case $words[1] in
1538
+ set) _postman_webhook_scripts_set ;;
1539
+ esac
1540
+ ;;
1541
+ esac
1542
+ }
1543
+
1544
+ _postman_webhook_scripts_commands() {
1545
+ local -a sub
1546
+ sub=(
1547
+ 'set:Create or update a webhook script from a JavaScript or TypeScript file.'
1548
+ )
1549
+ _describe -t commands 'scripts command' sub
1550
+ }
1551
+
1552
+ _postman_webhook_scripts_set() {
1553
+ _arguments \
1554
+ '--event[Script event\: onEvent or onResponse]:event' \
1555
+ '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)]:workspaceId' \
1556
+ '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
1557
+ '(-h --help)'{-h,--help}'[display help for command]' \
1558
+ '*:scriptPath:'
1559
+ }
1560
+
1461
1561
  _postman_webhook_forward() {
1462
1562
  _arguments \
1463
1563
  '(-w --workspace)'{-w,--workspace}'[Postman workspace ID]:workspaceId' \
@@ -1495,7 +1595,7 @@ _postman_dataset_commands() {
1495
1595
  'get:\[BETA\] Print a dataset'\''s metadata and structure summary (local YAML path or cloud id).'
1496
1596
  'query:\[BETA\] Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
1497
1597
  'create:\[BETA\] Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
1498
- 'delete:\[BETA\] Permanently remove a dataset\: a local .dataset.yaml (+ .resources/) or a cloud dataset id.'
1598
+ 'delete:\[BETA\] Permanently remove a dataset\: a local .dataset.yaml or a cloud dataset id.'
1499
1599
  'source:\[BETA\] Inspect and manage a dataset'\''s datasources.'
1500
1600
  'view:\[BETA\] Inspect and manage saved views on a dataset.'
1501
1601
  )
@@ -1523,9 +1623,10 @@ _postman_dataset_get() {
1523
1623
  _postman_dataset_query() {
1524
1624
  _arguments \
1525
1625
  '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
1526
- '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
1626
+ '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
1527
1627
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1528
1628
  '--json[Output rows as JSON instead of a table]' \
1629
+ '--debug[Include safe classified dataset diagnostics]' \
1529
1630
  '(-h --help)'{-h,--help}'[display help for command]' \
1530
1631
  '*:datasetPathOrId:'
1531
1632
  }
@@ -1545,7 +1646,7 @@ _postman_dataset_create() {
1545
1646
  _postman_dataset_delete() {
1546
1647
  _arguments \
1547
1648
  '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
1548
- '--keep-resources[Delete only the YAML file; leave the .resources/ directory intact (local only)]' \
1649
+ '--keep-resources[Preserve the local resource directory even when it is empty (local only)]' \
1549
1650
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1550
1651
  '(-h --help)'{-h,--help}'[display help for command]' \
1551
1652
  '*:datasetPathOrId:'
@@ -1591,25 +1692,38 @@ _postman_dataset_source_list() {
1591
1692
 
1592
1693
  _postman_dataset_source_add() {
1593
1694
  _arguments \
1594
- '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1695
+ '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to; positional target is also accepted for v1.45 compatibility]:datasetPathOrId' \
1595
1696
  '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
1596
- '--source-id[Override the generated source id]:uuid' \
1597
- '--format[Override the inferred format]:csv|json|mysql|postgres' \
1598
- '--type[Source kind; inferred from --file/--url when omitted]:local|remote-url|mysql|postgresql' \
1697
+ '--source-id[Override the generated source id (local dataset only)]:uuid' \
1698
+ '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
1699
+ '--type[Source kind; local is inferred when --file is provided]:local|mysql|postgresql|sqlserver' \
1599
1700
  '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
1600
1701
  '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
1601
1702
  '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
1602
1703
  '--upload[Cloud dataset only\: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem csv/json source read by the local engine.]' \
1603
- '--url[HTTP(S) URL to a remote CSV/JSON file]:url' \
1604
- '--host[DB host (mysql/postgresql)]:host' \
1605
- '--port[DB port]:port' \
1704
+ '--host[DB host (mysql/postgresql/sqlserver)]:host' \
1705
+ '--port[DB port (defaults to 1433 for sqlserver)]:port' \
1606
1706
  '--user[DB user (warning\: stored as plaintext in the YAML).]:user' \
1607
1707
  '--password[DB password. WARNING\: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.]:password' \
1608
1708
  '--database[DB database name]:db' \
1609
- '--table[DB table name (optional)]:table' \
1610
- '--slug[Optional slug for the source]:slug' \
1709
+ '--table[DB table name (required for sqlserver)]:table' \
1710
+ '--ssh-host[SSH bastion host]:host' \
1711
+ '--ssh-port[SSH bastion port]:port' \
1712
+ '--ssh-user[SSH bastion user]:user' \
1713
+ '--ssh-private-key[Path to the SSH private key. WARNING\: the path is visible in `ps` output and shell history; key contents are read locally at execution time and are not stored in the dataset config.]:filepath:_files -g "*.(pem|crt|key)"' \
1714
+ '--ssh-host-key[SSH bastion public host key]:publicKey' \
1715
+ '--ssh-host-key-vault-id[Shared Vault ID containing the SSH public host key]:id' \
1716
+ '--ssh-host-key-secret-id[Shared Vault secret ID containing the SSH public host key]:id' \
1717
+ '--ssh-insecure-skip-host-key-verification[WARNING\: disable SSH host-key verification; use only for trusted local testing]' \
1718
+ '--schema[DB schema (postgresql/sqlserver; defaults to dbo for sqlserver)]:schema' \
1719
+ '--encrypt[SQL Server TLS encryption (default\: true)]:true|false' \
1720
+ '--trust-server-certificate[SQL Server\: skip certificate verification (default\: false; insecure)]:true|false' \
1721
+ '--tls-certificate[SQL Server CA/server certificate file path]:path:_files -g "*.(pem|crt|key)"' \
1722
+ '--host-name-in-certificate[SQL Server certificate hostname override]:hostname' \
1723
+ '--tls-min-version[SQL Server minimum TLS version (default\: 1.2)]:1.2|1.3' \
1611
1724
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1612
- '(-h --help)'{-h,--help}'[display help for command]'
1725
+ '(-h --help)'{-h,--help}'[display help for command]' \
1726
+ '*:datasetPathOrId:'
1613
1727
  }
1614
1728
 
1615
1729
  _postman_dataset_source_remove() {
@@ -1624,18 +1738,30 @@ _postman_dataset_source_update() {
1624
1738
  _arguments \
1625
1739
  '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1626
1740
  '(-n --name)'{-n,--name}'[Rename the source]:name' \
1627
- '--format[Change the format]:csv|json|mysql|postgres' \
1628
- '--file[Replace the source'\''s file (local-filesystem only)]:path:_files -g "*.json"' \
1629
- '--ref-only[When using --file, reference in place instead of copying]' \
1630
- '--force[When copying with --file, overwrite existing destination]' \
1631
- '--url[Replace the remote URL (remote-url only)]:url' \
1632
- '--host[Update DB host (mysql/postgresql)]:host' \
1741
+ '--format[Change the format (local dataset only; cloud source formats are immutable)]:csv|json|mysql|postgres|sqlserver' \
1742
+ '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
1743
+ '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
1744
+ '--force[With --file, overwrite the copied destination (local dataset only)]' \
1745
+ '--host[Update DB host (mysql/postgresql/sqlserver)]:host' \
1633
1746
  '--port[Update DB port]:port' \
1634
1747
  '--user[Update DB user (warning\: stored as plaintext in the YAML).]:user' \
1635
1748
  '--password[Update DB password. WARNING\: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.]:password' \
1636
1749
  '--database[Update DB database name]:db' \
1637
1750
  '--table[Update DB table name]:table' \
1638
- '--slug[Update slug]:slug' \
1751
+ '--ssh-host[Update SSH bastion host]:host' \
1752
+ '--ssh-port[Update SSH bastion port]:port' \
1753
+ '--ssh-user[Update SSH bastion user]:user' \
1754
+ '--ssh-private-key[Update the SSH private-key file path. WARNING\: the path is visible in `ps` output and shell history; key contents are read locally and are not stored in the dataset config.]:filepath:_files -g "*.(pem|crt|key)"' \
1755
+ '--ssh-host-key[Update the SSH bastion public host key]:publicKey' \
1756
+ '--ssh-host-key-vault-id[Update the Shared Vault ID containing the SSH public host key]:id' \
1757
+ '--ssh-host-key-secret-id[Update the Shared Vault secret ID containing the SSH public host key]:id' \
1758
+ '--ssh-insecure-skip-host-key-verification[WARNING\: disable SSH host-key verification; use only for trusted local testing]' \
1759
+ '--schema[Update DB schema (postgresql/sqlserver)]:schema' \
1760
+ '--encrypt[Update SQL Server TLS encryption]:true|false' \
1761
+ '--trust-server-certificate[Update SQL Server certificate verification (true is insecure)]:true|false' \
1762
+ '--tls-certificate[Update SQL Server CA/server certificate file path]:path:_files -g "*.(pem|crt|key)"' \
1763
+ '--host-name-in-certificate[Update SQL Server certificate hostname override]:hostname' \
1764
+ '--tls-min-version[Update SQL Server minimum TLS version]:1.2|1.3' \
1639
1765
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1640
1766
  '(-h --help)'{-h,--help}'[display help for command]' \
1641
1767
  '*:sourceNameOrId:'
@@ -1684,9 +1810,10 @@ _postman_dataset_view_list() {
1684
1810
  _postman_dataset_view_run() {
1685
1811
  _arguments \
1686
1812
  '(-d --dataset)'{-d,--dataset}'[Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1687
- '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
1813
+ '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
1688
1814
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1689
1815
  '--json[Output rows as JSON instead of a table]' \
1816
+ '--debug[Include safe classified dataset diagnostics]' \
1690
1817
  '(-h --help)'{-h,--help}'[display help for command]' \
1691
1818
  '*:viewNameOrId:'
1692
1819
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "postman-cli-completion",
3
- "version": "1.48.0",
3
+ "version": "1.51.0",
4
4
  "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
5
5
  "type": "module",
6
6
  "bin": {