postman-cli-completion 1.49.0 → 1.52.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.49.0)
1
+ # Bash completion for Postman CLI (postman v1.52.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
@@ -143,7 +143,7 @@ _postman_collection_ai_readiness() {
143
143
 
144
144
  _postman_collection_run() {
145
145
  if [[ "$cur" == -* ]]; then
146
- COMPREPLY=( $(compgen -W "-e --environment -g --globals -r --reporters --output --reporter-json-structure -n --iteration-count -d --iteration-data --iteration-data-dataset --iteration-data-view --dataset -i --global-var --env-var --integration-id --postman-api-key --alias --bail --ignore-redirects -x --suppress-exit-code --silent --disable-unicode --delay-request --timeout --timeout-request --timeout-script --working-dir --no-insecure-file-read -k --insecure --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase --ssl-extra-ca-certs --cookie-jar --export-cookie-jar --verbose --mock --port --simulate --report-events -h --help --reporter-json-export --reporter-junit-export --reporter-html-export --reporter-json-omitRequestBodies --reporter-html-omitRequestBodies --reporter-json-omitResponseBodies --reporter-html-omitResponseBodies --reporter-json-omitHeaders --reporter-html-omitHeaders --reporter-json-omitAllHeadersAndBody --reporter-html-omitAllHeadersAndBody" -- "$cur") )
146
+ COMPREPLY=( $(compgen -W "-e --environment -g --globals -r --reporters --output --reporter-json-structure -n --iteration-count -d --iteration-data --iteration-data-dataset --iteration-data-view --dataset -i --global-var --env-var --integration-id --postman-api-key --alias --bail --ignore-redirects -x --suppress-exit-code --silent --disable-unicode --delay-request --timeout --timeout-request --timeout-script --working-dir --no-insecure-file-read -k --insecure --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase --ssl-extra-ca-certs --cookie-jar --export-cookie-jar --verbose --mock --port --use-mock --simulate --report-events --no-report-events -h --help --reporter-json-export --reporter-junit-export --reporter-html-export --reporter-json-omitRequestBodies --reporter-html-omitRequestBodies --reporter-json-omitResponseBodies --reporter-html-omitResponseBodies --reporter-json-omitHeaders --reporter-html-omitHeaders --reporter-json-omitAllHeadersAndBody --reporter-html-omitAllHeadersAndBody" -- "$cur") )
147
147
  return 0
148
148
  fi
149
149
  case "$prev" in
@@ -308,7 +308,7 @@ _postman_runner() {
308
308
 
309
309
  _postman_runner_start() {
310
310
  if [[ "$cur" == -* ]]; then
311
- COMPREPLY=( $(compgen -W "--id --key --region --proxy --egress-proxy --egress-proxy-authz-url --ssl-extra-ca-certs --metrics --metrics-port --report-events -h --help" -- "$cur") )
311
+ COMPREPLY=( $(compgen -W "--id --key --region --proxy --egress-proxy --egress-proxy-authz-url --ssl-extra-ca-certs --metrics --metrics-port --report-events --no-report-events -h --help" -- "$cur") )
312
312
  return 0
313
313
  fi
314
314
  case "$prev" in
@@ -338,7 +338,7 @@ _postman_spec() {
338
338
 
339
339
  _postman_spec_lint() {
340
340
  if [[ "$cur" == -* ]]; then
341
- COMPREPLY=( $(compgen -W "-f --fail-severity -o --output --workspace-id --report-events -h --help" -- "$cur") )
341
+ COMPREPLY=( $(compgen -W "-f --fail-severity -o --output --workspace-id --report-events --no-report-events -h --help" -- "$cur") )
342
342
  return 0
343
343
  fi
344
344
  case "$prev" in
@@ -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
 
@@ -412,7 +414,7 @@ _postman_workspace_prepare() {
412
414
 
413
415
  _postman_workspace_push() {
414
416
  if [[ "$cur" == -* ]]; then
415
- COMPREPLY=( $(compgen -W "--no-prepare -y --yes --push-strategy --verbose --report-events -h --help" -- "$cur") )
417
+ COMPREPLY=( $(compgen -W "--no-prepare -y --yes --push-strategy --verbose --report-events --no-report-events -h --help" -- "$cur") )
416
418
  return 0
417
419
  fi
418
420
  case "$prev" in
@@ -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 --dataset-id --dataset-view-id --dataset-distribution --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 --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") )
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 --report-events --no-report-events --verbose --debug --json -h --help" -- "$cur") )
523
542
  return 0
524
543
  fi
525
544
  case "$prev" in
@@ -571,7 +590,7 @@ _postman_flows_get_run() {
571
590
 
572
591
  _postman_request() {
573
592
  if [[ "$cur" == -* ]]; then
574
- COMPREPLY=( $(compgen -W "-H --header -d --body -f --form -e --environment --timeout --redirects-ignore --redirects-max --redirects-follow-method --redirects-remove-referrer --retry --retry-delay --script-pre-request --script-post-request --dataset -o --output --verbose --response-only --debug -h --help --auth-basic-username --auth-basic-password --auth-bearer-token --auth-digest-username --auth-digest-password --auth-oauth1-consumerKey --auth-oauth1-consumerSecret --auth-oauth1-token --auth-oauth1-tokenSecret --auth-oauth2-accessToken --auth-oauth2-tokenType --auth-hawk-authId --auth-hawk-authKey --auth-hawk-algorithm --auth-aws-accessKey --auth-aws-secretKey --auth-aws-region --auth-aws-service --auth-aws-sessionToken --auth-ntlm-username --auth-ntlm-password --auth-ntlm-domain --auth-ntlm-workstation --auth-apikey-key --auth-apikey-value --auth-apikey-in" -- "$cur") )
593
+ COMPREPLY=( $(compgen -W "-H --header -d --body -f --form -e --environment --timeout --redirects-ignore --redirects-max --redirects-follow-method --redirects-remove-referrer --retry --retry-delay --script-pre-request --script-post-request --dataset -o --output --verbose --response-only --debug --report-events --no-report-events -h --help --auth-basic-username --auth-basic-password --auth-bearer-token --auth-digest-username --auth-digest-password --auth-oauth1-consumerKey --auth-oauth1-consumerSecret --auth-oauth1-token --auth-oauth1-tokenSecret --auth-oauth2-accessToken --auth-oauth2-tokenType --auth-hawk-authId --auth-hawk-authKey --auth-hawk-algorithm --auth-aws-accessKey --auth-aws-secretKey --auth-aws-region --auth-aws-service --auth-aws-sessionToken --auth-ntlm-username --auth-ntlm-password --auth-ntlm-domain --auth-ntlm-workstation --auth-apikey-key --auth-apikey-value --auth-apikey-in" -- "$cur") )
575
594
  return 0
576
595
  fi
577
596
  case "$prev" in
@@ -705,19 +724,22 @@ _postman_mock() {
705
724
  if [[ "$cur" == -* ]]; then
706
725
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
707
726
  else
708
- COMPREPLY=( $(compgen -W "generate run" -- "$cur") )
727
+ COMPREPLY=( $(compgen -W "generate run get list delete" -- "$cur") )
709
728
  fi
710
729
  return 0
711
730
  fi
712
731
  case "$subcmd" in
713
732
  generate) _postman_mock_generate ;;
714
733
  run) _postman_mock_run ;;
734
+ get) _postman_mock_get ;;
735
+ list) _postman_mock_list ;;
736
+ delete) _postman_mock_delete ;;
715
737
  esac
716
738
  }
717
739
 
718
740
  _postman_mock_generate() {
719
741
  if [[ "$cur" == -* ]]; then
720
- 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") )
721
743
  return 0
722
744
  fi
723
745
  case "$prev" in
@@ -743,6 +765,31 @@ _postman_mock_run() {
743
765
  _postman_filematch '!*.@(json)' "$cur"
744
766
  return 0 ;;
745
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"
746
793
  }
747
794
 
748
795
  _postman_application() {
@@ -750,13 +797,14 @@ _postman_application() {
750
797
  if [[ "$cur" == -* ]]; then
751
798
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
752
799
  else
753
- COMPREPLY=( $(compgen -W "init test" -- "$cur") )
800
+ COMPREPLY=( $(compgen -W "init test setup-capture" -- "$cur") )
754
801
  fi
755
802
  return 0
756
803
  fi
757
804
  case "$subcmd" in
758
805
  init) _postman_application_init ;;
759
806
  test) _postman_application_test ;;
807
+ setup-capture) _postman_application_setup_capture ;;
760
808
  esac
761
809
  }
762
810
 
@@ -771,7 +819,7 @@ _postman_application_init() {
771
819
 
772
820
  _postman_application_test() {
773
821
  if [[ "$cur" == -* ]]; then
774
- COMPREPLY=( $(compgen -W "--target --target-collection --target-environment --command --deployed-version --network-log --capture-only --output --force --report-events --verbose -h --help" -- "$cur") )
822
+ COMPREPLY=( $(compgen -W "--target --target-collection --target-environment --command --deployed-version --network-log --capture-only --output --force --report-events --no-report-events --verbose -h --help" -- "$cur") )
775
823
  return 0
776
824
  fi
777
825
  case "$prev" in
@@ -790,6 +838,18 @@ _postman_application_test() {
790
838
  esac
791
839
  }
792
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
+
793
853
  _postman_simulate() {
794
854
  if [[ -z "$subcmd" ]]; then
795
855
  if [[ "$cur" == -* ]]; then
@@ -1295,7 +1355,7 @@ _postman_dataset_get() {
1295
1355
 
1296
1356
  _postman_dataset_query() {
1297
1357
  if [[ "$cur" == -* ]]; then
1298
- 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") )
1299
1359
  return 0
1300
1360
  fi
1301
1361
  case "$prev" in
@@ -1361,13 +1421,19 @@ _postman_dataset_source_list() {
1361
1421
 
1362
1422
  _postman_dataset_source_add() {
1363
1423
  if [[ "$cur" == -* ]]; then
1364
- 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") )
1365
1425
  return 0
1366
1426
  fi
1367
1427
  case "$prev" in
1368
1428
  --file)
1369
1429
  _postman_filematch '!*.@(json)' "$cur"
1370
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 ;;
1371
1437
  --api-key)
1372
1438
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1373
1439
  return 0 ;;
@@ -1388,13 +1454,19 @@ _postman_dataset_source_remove() {
1388
1454
 
1389
1455
  _postman_dataset_source_update() {
1390
1456
  if [[ "$cur" == -* ]]; then
1391
- 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") )
1392
1458
  return 0
1393
1459
  fi
1394
1460
  case "$prev" in
1395
1461
  --file)
1396
1462
  _postman_filematch '!*.@(json)' "$cur"
1397
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 ;;
1398
1470
  --api-key)
1399
1471
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1400
1472
  return 0 ;;
@@ -1433,7 +1505,7 @@ _postman_dataset_view_list() {
1433
1505
 
1434
1506
  _postman_dataset_view_run() {
1435
1507
  if [[ "$cur" == -* ]]; then
1436
- 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") )
1437
1509
  return 0
1438
1510
  fi
1439
1511
  case "$prev" in
@@ -1,4 +1,4 @@
1
- # Fish completion for Postman CLI (postman v1.49.0)
1
+ # Fish completion for Postman CLI (postman v1.52.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 '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
@@ -116,8 +116,10 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
116
116
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l verbose -d 'Show detailed information of collection run and each request sent'
117
117
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l mock -d 'Start a mock server from manifest (.json, .yaml or .yml) file' -r
118
118
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l port -d 'Port for the --mock server; pass "auto" for an OS-assigned ephemeral port (default: configured port, falls back to an ephemeral one if busy). Only valid with --mock.' -x
119
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l use-mock -d 'Redirect requests for a URL or {{variable}} to a mock during the run. Format: "<url> mock|mock-server:<path|id> [scenario]". Repeat the flag to redirect multiple URLs (one --use-mock per mock). Use "mock:<path>" for a local mock manifest (.json/.yaml/.yml), "mock:<id>" for a local mock by id (fetched from the cloud then run locally), or "mock-server:<id>" to redirect to a deployed mock server\'s URL. Id-based references require `postman login` (or --postman-api-key). The optional third field selects a scenario (defaults to "default"). (default: [])' -x
119
120
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l simulate -d 'Start mock servers with fault-injection scenarios from a .sim.yaml file' -r
120
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l report-events -d 'Send run results and analytics to Postman'
121
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l report-events -d 'Upload results for git-native v3 collection runs. Analytics are sent by default'
122
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l no-report-events -d 'Do not send analytics to Postman'
121
123
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
122
124
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l reporter-json-export -d 'Path to save the report for the given reporter.' -r
123
125
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l reporter-junit-export -d 'Path to save the report for the given reporter.' -r
@@ -181,7 +183,8 @@ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subc
181
183
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l ssl-extra-ca-certs -d 'Additional trusted CA certificates (PEM file, can contain multiple certs)' -r
182
184
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l metrics -d 'Enable the metrics server for health checks'
183
185
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l metrics-port -d 'Port for the metrics server (default: "9090")' -x
184
- complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l report-events -d 'Send run events and analytics to Postman'
186
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
187
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l no-report-events -d 'Do not send analytics to Postman'
185
188
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -s h -l help -d 'display help for command'
186
189
 
187
190
  # ---------- spec ----------
@@ -192,7 +195,8 @@ complete -c postman -n '__fish_seen_subcommand_from spec' -s h -l help -d 'displ
192
195
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s f -l fail-severity -d 'Results of this level or above will trigger a failure exit code. [choices: "error", "warning", "info", "hint"] (default: "ERROR")' -x
193
196
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s o -l output -d 'Output format for the results. [choices: "json", "csv"]' -x
194
197
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l workspace-id -d 'The workspace ID to use for fetching governance rulesets.' -x
195
- complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l report-events -d 'Send lint results and analytics to Postman'
198
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
199
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l no-report-events -d 'Do not send analytics to Postman'
196
200
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
197
201
  # ---------- spec ai-readiness ----------
198
202
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -s o -l output -d 'Output format for the results. [choices: "cli", "json", "html"]' -x
@@ -208,10 +212,12 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
208
212
  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
213
 
210
214
  # ---------- 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.'
215
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a list -d 'List all available Postman Workspaces'
216
+ 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.'
217
+ 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.'
218
+ 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.'
219
+ 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.'
220
+ 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
221
  complete -c postman -n '__fish_seen_subcommand_from workspace' -s h -l help -d 'display help for command'
216
222
  # ---------- workspace list ----------
217
223
  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
@@ -228,14 +234,25 @@ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_s
228
234
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -s y -l yes -d 'Skip all confirmation prompts'
229
235
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l push-strategy -d 'Push strategy. "force-sync": mirror the whole workspace — also DELETE cloud entities that have no local counterpart (destructive). Defaults to "default" (create/update only).' -x
230
236
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l verbose -d 'Show detailed logging'
231
- complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l report-events -d 'Send workspace push events to Postman'
237
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
238
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l no-report-events -d 'Do not send analytics to Postman'
232
239
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -s h -l help -d 'display help for command'
233
240
  # ---------- workspace lint ----------
234
241
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s f -l fail-severity -d 'Exit with failure if diagnostics at this level or above are present. [choices: "error", "warning", "info", "hint"] (default: "error")' -x
235
242
  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
243
  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
244
  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
245
+ 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
246
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
247
+ # ---------- workspace pull ----------
248
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -s y -l yes -d 'Skip all confirmation prompts'
249
+ 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
250
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -l verbose -d 'Show detailed logging'
251
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -s h -l help -d 'display help for command'
252
+ # ---------- workspace connect-git ----------
253
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -l verbose -d 'Show detailed logging'
254
+ 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'
255
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -r -k -a '(__fish_complete_suffix .json)'
239
256
 
240
257
  # ---------- performance ----------
241
258
  complete -c postman -n '__postman_using_subcommand performance run' -a run -d 'Run a performance test on a collection'
@@ -251,6 +268,7 @@ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen
251
268
  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
252
269
  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
253
270
  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
271
+ 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
254
272
  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
255
273
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
256
274
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
@@ -310,6 +328,8 @@ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subco
310
328
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l reporters -d 'Save a test results report to a file (supported: html)' -x
311
329
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -s x -l suppress-exit-code -d 'Specify whether or not to override the default exit code for the current run'
312
330
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l workspace -d 'Workspace ID required for flows that contain connector blocks. Find it in the Postman app URL: https://postman.com/workspace/<workspaceId>' -x
331
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
332
+ complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l no-report-events -d 'Do not send analytics to Postman'
313
333
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l verbose -d 'Verbose output'
314
334
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l debug -d 'Debug output'
315
335
  complete -c postman -n '__fish_seen_subcommand_from flows; and __fish_seen_subcommand_from run' -l json -d 'JSON output'
@@ -358,6 +378,8 @@ complete -c postman -n '__fish_seen_subcommand_from request' -s o -l output -d '
358
378
  complete -c postman -n '__fish_seen_subcommand_from request' -l verbose -d 'Show detailed request and response information including headers, body, and metadata.'
359
379
  complete -c postman -n '__fish_seen_subcommand_from request' -l response-only -d 'suppress all output except response body. Useful for piping to other commands.'
360
380
  complete -c postman -n '__fish_seen_subcommand_from request' -l debug -d 'Debug mode: show detailed execution information including retry attempts, redirects, and timing breakdowns.'
381
+ complete -c postman -n '__fish_seen_subcommand_from request' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
382
+ complete -c postman -n '__fish_seen_subcommand_from request' -l no-report-events -d 'Do not send analytics to Postman'
361
383
  complete -c postman -n '__fish_seen_subcommand_from request' -s h -l help -d 'display help for command'
362
384
  complete -c postman -n '__fish_seen_subcommand_from request' -l auth-basic-username -d 'Supply authentication parameters dynamically.' -x
363
385
  complete -c postman -n '__fish_seen_subcommand_from request' -l auth-basic-password -d 'Supply authentication parameters dynamically.' -x
@@ -461,12 +483,15 @@ complete -c postman -n '__fish_seen_subcommand_from sdk; and __fish_seen_subcomm
461
483
  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'
462
484
 
463
485
  # ---------- mock ----------
464
- 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.'
465
- 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).'
486
+ 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.'
487
+ 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.'
488
+ 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.'
489
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a list -d 'List local mocks found under a directory.'
490
+ complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a delete -d 'Permanently remove a local mock artifact.'
466
491
  complete -c postman -n '__fish_seen_subcommand_from mock' -s h -l help -d 'display help for command'
467
492
  # ---------- mock generate ----------
468
493
  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
469
- 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
494
+ 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
470
495
  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
471
496
  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'
472
497
  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
@@ -477,10 +502,24 @@ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcom
477
502
  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
478
503
  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
479
504
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
505
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
506
+ # ---------- mock get ----------
507
+ 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'
508
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
509
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
510
+ # ---------- mock list ----------
511
+ 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'
512
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
513
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
514
+ # ---------- mock delete ----------
515
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
516
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
517
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -r -k -a '(__fish_complete_suffix .json)'
480
518
 
481
519
  # ---------- application ----------
482
- 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.'
483
- 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.'
520
+ 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.'
521
+ 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.'
522
+ 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().'
484
523
  complete -c postman -n '__fish_seen_subcommand_from application' -s h -l help -d 'display help for command'
485
524
  # ---------- application init ----------
486
525
  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
@@ -500,9 +539,13 @@ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen
500
539
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l capture-only -d 'Skip collection matching and tests; capture traffic and save a V3 collection organised by host'
501
540
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l output -d 'Output directory for captured collection (default: pm-results/captured/; used with --capture-only)' -r
502
541
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l force -d 'Overwrite the output directory if it exists and is not empty (used with --capture-only)'
503
- 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'
542
+ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l report-events -d 'Send application test run results to Postman (default: true)' -x
543
+ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l no-report-events -d 'Do not send run results or analytics to Postman'
504
544
  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'
505
545
  complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -s h -l help -d 'display help for command'
546
+ # ---------- application setup-capture ----------
547
+ 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
548
+ 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'
506
549
 
507
550
  # ---------- simulate ----------
508
551
  complete -c postman -n '__postman_using_subcommand simulate run' -a run -d 'Start mocks with fault-injection scenarios defined in a .sim.yaml file'
@@ -670,13 +713,13 @@ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_sub
670
713
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from forward' -s h -l help -d 'display help for command'
671
714
 
672
715
  # ---------- dataset ----------
673
- complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a list -d '[BETA] List local dataset YAMLs under a path, or (no path) a workspace\'s cloud datasets.'
674
- 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).'
675
- 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).'
676
- 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.'
677
- 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.'
678
- 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.'
679
- 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.'
716
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a list -d 'List local dataset YAMLs under a path, or (no path) a workspace\'s cloud datasets.'
717
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a get -d 'Print a dataset\'s metadata and structure summary (local YAML path or cloud id).'
718
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a query -d 'Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
719
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a create -d 'Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
720
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a delete -d 'Permanently remove a dataset: a local .dataset.yaml or a cloud dataset id.'
721
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a source -d 'Inspect and manage a dataset\'s datasources.'
722
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a view -d 'Inspect and manage saved views on a dataset.'
680
723
  complete -c postman -n '__fish_seen_subcommand_from dataset' -s h -l help -d 'display help for command'
681
724
  # ---------- dataset list ----------
682
725
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Postman workspace ID (cloud list)' -x
@@ -691,9 +734,10 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
691
734
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
692
735
  # ---------- dataset query ----------
693
736
  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
694
- 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
737
+ 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
695
738
  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
696
739
  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'
740
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l debug -d 'Include safe classified dataset diagnostics'
697
741
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s h -l help -d 'display help for command'
698
742
  # ---------- dataset create ----------
699
743
  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
@@ -706,14 +750,14 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
706
750
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -r -k -a '(__fish_complete_suffix .json)'
707
751
  # ---------- dataset delete ----------
708
752
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
709
- 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)'
753
+ 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)'
710
754
  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
711
755
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
712
756
  # ---------- dataset source ----------
713
- complete -c postman -n '__postman_using_subcommand source list add remove update' -a list -d '[BETA] List the datasources defined on a dataset (local YAML path or cloud id).'
714
- complete -c postman -n '__postman_using_subcommand source list add remove update' -a add -d '[BETA] Add a datasource to a dataset.'
715
- complete -c postman -n '__postman_using_subcommand source list add remove update' -a remove -d '[BETA] Remove a datasource from a dataset (local YAML path or cloud id).'
716
- complete -c postman -n '__postman_using_subcommand source list add remove update' -a update -d '[BETA] Update fields on an existing datasource. Only the flags you provide are changed.'
757
+ complete -c postman -n '__postman_using_subcommand source list add remove update' -a list -d 'List the datasources defined on a dataset (local YAML path or cloud id).'
758
+ complete -c postman -n '__postman_using_subcommand source list add remove update' -a add -d 'Add a datasource to a dataset.'
759
+ complete -c postman -n '__postman_using_subcommand source list add remove update' -a remove -d 'Remove a datasource from a dataset (local YAML path or cloud id).'
760
+ complete -c postman -n '__postman_using_subcommand source list add remove update' -a update -d 'Update fields on an existing datasource. Only the flags you provide are changed.'
717
761
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source' -s h -l help -d 'display help for command'
718
762
  # ---------- dataset source list ----------
719
763
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -s d -l dataset -d 'Dataset whose sources to list — a local .dataset.yaml path or a cloud dataset id' -x
@@ -721,23 +765,35 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
721
765
  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'
722
766
  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'
723
767
  # ---------- dataset source add ----------
724
- 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
768
+ 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
725
769
  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
726
- 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
727
- 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
728
- 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
770
+ 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
771
+ 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
772
+ 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
729
773
  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
730
774
  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)'
731
775
  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)'
732
776
  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.'
733
- 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
734
- 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
735
- 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
777
+ 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
778
+ 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
736
779
  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
737
780
  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
738
781
  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
739
- 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
740
- 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
782
+ 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
783
+ 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
784
+ 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
785
+ 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
786
+ 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
787
+ 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
788
+ 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
789
+ 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
790
+ 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'
791
+ 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
792
+ 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
793
+ 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
794
+ 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
795
+ 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
796
+ 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
741
797
  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
742
798
  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'
743
799
  # ---------- dataset source remove ----------
@@ -747,26 +803,38 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
747
803
  # ---------- dataset source update ----------
748
804
  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
749
805
  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
750
- 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
751
- 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
752
- 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'
753
- 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'
754
- 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
755
- 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
806
+ 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
807
+ 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
808
+ 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)'
809
+ 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)'
810
+ 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
756
811
  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
757
812
  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
758
813
  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
759
814
  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
760
815
  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
761
- 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
816
+ 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
817
+ 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
818
+ 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
819
+ 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
820
+ 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
821
+ 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
822
+ 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
823
+ 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'
824
+ 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
825
+ 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
826
+ 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
827
+ 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
828
+ 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
829
+ 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
762
830
  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
763
831
  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'
764
832
  # ---------- dataset view ----------
765
- complete -c postman -n '__postman_using_subcommand view list run create delete update' -a list -d '[BETA] List the saved views defined on a dataset (local YAML path or cloud id).'
766
- complete -c postman -n '__postman_using_subcommand view list run create delete update' -a run -d '[BETA] Execute a saved view against a dataset and print the rows.'
767
- complete -c postman -n '__postman_using_subcommand view list run create delete update' -a create -d '[BETA] Add a saved view to a dataset (local YAML path or cloud id).'
768
- complete -c postman -n '__postman_using_subcommand view list run create delete update' -a delete -d '[BETA] Remove a saved view from a dataset (local YAML path or cloud id).'
769
- complete -c postman -n '__postman_using_subcommand view list run create delete update' -a update -d '[BETA] Update name and/or query on an existing view (local YAML path or cloud id).'
833
+ complete -c postman -n '__postman_using_subcommand view list run create delete update' -a list -d 'List the saved views defined on a dataset (local YAML path or cloud id).'
834
+ complete -c postman -n '__postman_using_subcommand view list run create delete update' -a run -d 'Execute a saved view against a dataset and print the rows.'
835
+ complete -c postman -n '__postman_using_subcommand view list run create delete update' -a create -d 'Add a saved view to a dataset (local YAML path or cloud id).'
836
+ complete -c postman -n '__postman_using_subcommand view list run create delete update' -a delete -d 'Remove a saved view from a dataset (local YAML path or cloud id).'
837
+ complete -c postman -n '__postman_using_subcommand view list run create delete update' -a update -d 'Update name and/or query on an existing view (local YAML path or cloud id).'
770
838
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view' -s h -l help -d 'display help for command'
771
839
  # ---------- dataset view list ----------
772
840
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -s d -l dataset -d 'Dataset whose views to list — a local .dataset.yaml path or a cloud dataset id' -x
@@ -775,9 +843,10 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
775
843
  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'
776
844
  # ---------- dataset view run ----------
777
845
  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
778
- 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
846
+ 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
779
847
  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
780
848
  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'
849
+ 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'
781
850
  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'
782
851
  # ---------- dataset view create ----------
783
852
  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.49.0)
3
+ # Zsh completion for Postman CLI (postman v1.52.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:Work with Postman datasets in local YAML files or the cloud.'
76
76
  )
77
77
  _describe -t commands 'postman command' commands
78
78
  }
@@ -185,8 +185,10 @@ _postman_collection_run() {
185
185
  '--verbose[Show detailed information of collection run and each request sent]' \
186
186
  '--mock[Start a mock server from manifest (.json, .yaml or .yml) file]:path:_files -g "*.json"' \
187
187
  '--port[Port for the --mock server; pass "auto" for an OS-assigned ephemeral port (default\: configured port, falls back to an ephemeral one if busy). Only valid with --mock.]:port' \
188
+ '--use-mock[Redirect requests for a URL or {{variable}} to a mock during the run. Format\: "<url> mock|mock-server\:<path|id> \[scenario\]". Repeat the flag to redirect multiple URLs (one --use-mock per mock). Use "mock\:<path>" for a local mock manifest (.json/.yaml/.yml), "mock\:<id>" for a local mock by id (fetched from the cloud then run locally), or "mock-server\:<id>" to redirect to a deployed mock server'\''s URL. Id-based references require `postman login` (or --postman-api-key). The optional third field selects a scenario (defaults to "default"). (default\: \[\])]:mapping' \
188
189
  '--simulate[Start mock servers with fault-injection scenarios from a .sim.yaml file]:path:_files -g "*.(sim.yaml|yaml|yml)"' \
189
- '--report-events[Send run results and analytics to Postman]' \
190
+ '--report-events[Upload results for git-native v3 collection runs. Analytics are sent by default]' \
191
+ '--no-report-events[Do not send analytics to Postman]' \
190
192
  '(-h --help)'{-h,--help}'[display help for command]' \
191
193
  '--reporter-json-export[Path to save the report for the given reporter.]:value:_files -g "*.(json|xml|html)"' \
192
194
  '--reporter-junit-export[Path to save the report for the given reporter.]:value:_files -g "*.(json|xml|html)"' \
@@ -348,7 +350,8 @@ _postman_runner_start() {
348
350
  '--ssl-extra-ca-certs[Additional trusted CA certificates (PEM file, can contain multiple certs)]:path:_files -g "*.(pem|crt|key)"' \
349
351
  '--metrics[Enable the metrics server for health checks]' \
350
352
  '--metrics-port[Port for the metrics server (default\: "9090")]:port' \
351
- '--report-events[Send run events and analytics to Postman]' \
353
+ '--report-events[Accepted for compatibility; analytics are sent by default]' \
354
+ '--no-report-events[Do not send analytics to Postman]' \
352
355
  '(-h --help)'{-h,--help}'[display help for command]'
353
356
  }
354
357
 
@@ -383,7 +386,8 @@ _postman_spec_lint() {
383
386
  '(-f --fail-severity)'{-f,--fail-severity}'[Results of this level or above will trigger a failure exit code. \[choices\: "error", "warning", "info", "hint"\] (default\: "ERROR")]:value' \
384
387
  '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "json", "csv"\]]:value' \
385
388
  '--workspace-id[The workspace ID to use for fetching governance rulesets.]:value' \
386
- '--report-events[Send lint results and analytics to Postman]' \
389
+ '--report-events[Accepted for compatibility; analytics are sent by default]' \
390
+ '--no-report-events[Do not send analytics to Postman]' \
387
391
  '(-h --help)'{-h,--help}'[display help for command]' \
388
392
  '*:spec:'
389
393
  }
@@ -442,6 +446,8 @@ _postman_workspace() {
442
446
  prepare) _postman_workspace_prepare ;;
443
447
  push) _postman_workspace_push ;;
444
448
  lint) _postman_workspace_lint ;;
449
+ pull) _postman_workspace_pull ;;
450
+ connect-git) _postman_workspace_connect_git ;;
445
451
  esac
446
452
  ;;
447
453
  esac
@@ -454,6 +460,8 @@ _postman_workspace_commands() {
454
460
  'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
455
461
  'push:Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
456
462
  'lint:Lint the current local Postman workspace\: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
463
+ 'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
464
+ 'connect-git:Connect a Postman workspace to a local git repository.'
457
465
  )
458
466
  _describe -t commands 'workspace command' sub
459
467
  }
@@ -480,7 +488,8 @@ _postman_workspace_push() {
480
488
  '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
481
489
  '--push-strategy[Push strategy. "force-sync"\: mirror the whole workspace — also DELETE cloud entities that have no local counterpart (destructive). Defaults to "default" (create/update only).]:strategy' \
482
490
  '--verbose[Show detailed logging]' \
483
- '--report-events[Send workspace push events to Postman]' \
491
+ '--report-events[Accepted for compatibility; analytics are sent by default]' \
492
+ '--no-report-events[Do not send analytics to Postman]' \
484
493
  '(-h --help)'{-h,--help}'[display help for command]'
485
494
  }
486
495
 
@@ -490,9 +499,26 @@ _postman_workspace_lint() {
490
499
  '(-o --output)'{-o,--output}'[Output format\: cli (human-readable), table, or json. (default\: "cli")]:value' \
491
500
  '--meta[Only lint the workspace configuration (.postman/resources.yaml); skip per-entity linting.]' \
492
501
  '--workspace-id[The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.]:value' \
502
+ '--fix[Apply safe autofixes to repairable workspace lint issues.]' \
493
503
  '(-h --help)'{-h,--help}'[display help for command]'
494
504
  }
495
505
 
506
+ _postman_workspace_pull() {
507
+ _arguments \
508
+ '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
509
+ '--source-workspace[Pull from a different source workspace.]:workspaceId' \
510
+ '--verbose[Show detailed logging]' \
511
+ '(-h --help)'{-h,--help}'[display help for command]' \
512
+ '*:workspaceId:'
513
+ }
514
+
515
+ _postman_workspace_connect_git() {
516
+ _arguments \
517
+ '--verbose[Show detailed logging]' \
518
+ '(-h --help)'{-h,--help}'[display help for command]' \
519
+ '*:path:_files -g "*.json"'
520
+ }
521
+
496
522
  _postman_performance() {
497
523
  local context state state_descr line
498
524
  typeset -A opt_args
@@ -529,6 +555,7 @@ _postman_performance_run() {
529
555
  '--dataset-view-id[Dataset view to execute for iteration data (requires --dataset-id)]:id' \
530
556
  '--dataset-distribution[How rows map to VUs\: round-robin (default), fixed, random]:strategy' \
531
557
  '--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' \
558
+ '--runner[Runner to execute the performance test on (local or postman-cloud) (default\: local)]:runner' \
532
559
  '--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' \
533
560
  '(-h --help)'{-h,--help}'[display help for command]' \
534
561
  '*:collectionId:_files -g "*.json"'
@@ -628,6 +655,8 @@ _postman_flows_run() {
628
655
  '--reporters[Save a test results report to a file (supported\: html)]:format' \
629
656
  '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Specify whether or not to override the default exit code for the current run]' \
630
657
  '--workspace[Workspace ID required for flows that contain connector blocks. Find it in the Postman app URL\: https\://postman.com/workspace/<workspaceId>]:workspaceId' \
658
+ '--report-events[Accepted for compatibility; analytics are sent by default]' \
659
+ '--no-report-events[Do not send analytics to Postman]' \
631
660
  '--verbose[Verbose output]' \
632
661
  '--debug[Debug output]' \
633
662
  '--json[JSON output]' \
@@ -688,6 +717,8 @@ _postman_request() {
688
717
  '--verbose[Show detailed request and response information including headers, body, and metadata.]' \
689
718
  '--response-only[suppress all output except response body. Useful for piping to other commands.]' \
690
719
  '--debug[Debug mode\: show detailed execution information including retry attempts, redirects, and timing breakdowns.]' \
720
+ '--report-events[Accepted for compatibility; analytics are sent by default]' \
721
+ '--no-report-events[Do not send analytics to Postman]' \
691
722
  '(-h --help)'{-h,--help}'[display help for command]' \
692
723
  '--auth-basic-username[Supply authentication parameters dynamically.]:value' \
693
724
  '--auth-basic-password[Supply authentication parameters dynamically.]:value' \
@@ -882,6 +913,9 @@ _postman_mock() {
882
913
  case $words[1] in
883
914
  generate) _postman_mock_generate ;;
884
915
  run) _postman_mock_run ;;
916
+ get) _postman_mock_get ;;
917
+ list) _postman_mock_list ;;
918
+ delete) _postman_mock_delete ;;
885
919
  esac
886
920
  ;;
887
921
  esac
@@ -890,8 +924,11 @@ _postman_mock() {
890
924
  _postman_mock_commands() {
891
925
  local -a sub
892
926
  sub=(
893
- '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.'
894
- 'run:Start a local mock server given a manifest file (JSON or YAML).'
927
+ '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.'
928
+ 'run:Start a local mock server given a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
929
+ 'get:Show a local mock'\''s details and run status.'
930
+ 'list:List local mocks found under a directory.'
931
+ 'delete:Permanently remove a local mock artifact.'
895
932
  )
896
933
  _describe -t commands 'mock command' sub
897
934
  }
@@ -899,7 +936,7 @@ _postman_mock_commands() {
899
936
  _postman_mock_generate() {
900
937
  _arguments \
901
938
  '(-o --output)'{-o,--output}'[Output directory for the mock (default\: postman/mocks/<slug>)]:dir:_files -g "*.json"' \
902
- '--name[Display name for the generated mock]:name' \
939
+ '(-n --name)'{-n,--name}'[Display name for the generated mock. Optional with a source (derived from it); required when generating without a source.]:name' \
903
940
  '--port[Port the mock server should listen on (default\: 4500)]:port' \
904
941
  '--force[Overwrite the config.yaml/default.js in the output directory if it already exists]' \
905
942
  '(-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"' \
@@ -914,7 +951,28 @@ _postman_mock_run() {
914
951
  '(-g --globals)'{-g,--globals}'[Path to a globals file (JSON or YAML) for pm.globals]:path:_files -g "*.json"' \
915
952
  '(-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' \
916
953
  '(-h --help)'{-h,--help}'[display help for command]' \
917
- '*:manifestPath:'
954
+ '*:pathOrDir:_files -g "*.json"'
955
+ }
956
+
957
+ _postman_mock_get() {
958
+ _arguments \
959
+ '--json[Output the mock details as JSON instead of a table]' \
960
+ '(-h --help)'{-h,--help}'[display help for command]' \
961
+ '*:pathOrDir:_files -g "*.json"'
962
+ }
963
+
964
+ _postman_mock_list() {
965
+ _arguments \
966
+ '--json[Output the mock list as JSON instead of a table]' \
967
+ '(-h --help)'{-h,--help}'[display help for command]' \
968
+ '*:pathOrDir:_files -g "*.json"'
969
+ }
970
+
971
+ _postman_mock_delete() {
972
+ _arguments \
973
+ '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
974
+ '(-h --help)'{-h,--help}'[display help for command]' \
975
+ '*:pathOrDir:_files -g "*.json"'
918
976
  }
919
977
 
920
978
  _postman_application() {
@@ -929,6 +987,7 @@ _postman_application() {
929
987
  case $words[1] in
930
988
  init) _postman_application_init ;;
931
989
  test) _postman_application_test ;;
990
+ setup-capture) _postman_application_setup_capture ;;
932
991
  esac
933
992
  ;;
934
993
  esac
@@ -937,8 +996,9 @@ _postman_application() {
937
996
  _postman_application_commands() {
938
997
  local -a sub
939
998
  sub=(
940
- 'init:Initialise a postman.config.cjs file with target collections, environment, and test command.'
999
+ 'init:\[DEPRECATED\] Use `postman app test` instead. Initialise a postman.config.cjs file with target collections, environment, and test command.'
941
1000
  'test:Run a command first (primary task), then match captured traffic against Postman collections and run assertions.'
1001
+ 'setup-capture:Install postman-playwright and patch playwright.config.* to capture network traffic automatically via withPostman().'
942
1002
  )
943
1003
  _describe -t commands 'application command' sub
944
1004
  }
@@ -965,11 +1025,18 @@ _postman_application_test() {
965
1025
  '--capture-only[Skip collection matching and tests; capture traffic and save a V3 collection organised by host]' \
966
1026
  '--output[Output directory for captured collection (default\: pm-results/captured/; used with --capture-only)]:path:_files -g "*.json"' \
967
1027
  '--force[Overwrite the output directory if it exists and is not empty (used with --capture-only)]' \
968
- '--report-events[Send application test run results and analytics to Postman]' \
1028
+ '--report-events[Send application test run results to Postman (default\: true)]:boolean' \
1029
+ '--no-report-events[Do not send run results or analytics to Postman]' \
969
1030
  '--verbose[Show detailed per-request matching, sandbox errors, and debug information]' \
970
1031
  '(-h --help)'{-h,--help}'[display help for command]'
971
1032
  }
972
1033
 
1034
+ _postman_application_setup_capture() {
1035
+ _arguments \
1036
+ '--config[Path to playwright.config.* to patch (default\: auto-detect)]:path:_files -g "*.json"' \
1037
+ '(-h --help)'{-h,--help}'[display help for command]'
1038
+ }
1039
+
973
1040
  _postman_simulate() {
974
1041
  local context state state_descr line
975
1042
  typeset -A opt_args
@@ -1534,13 +1601,13 @@ _postman_dataset() {
1534
1601
  _postman_dataset_commands() {
1535
1602
  local -a sub
1536
1603
  sub=(
1537
- 'list:\[BETA\] List local dataset YAMLs under a path, or (no path) a workspace'\''s cloud datasets.'
1538
- 'get:\[BETA\] Print a dataset'\''s metadata and structure summary (local YAML path or cloud id).'
1539
- 'query:\[BETA\] Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
1540
- 'create:\[BETA\] Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
1541
- 'delete:\[BETA\] Permanently remove a dataset\: a local .dataset.yaml (+ .resources/) or a cloud dataset id.'
1542
- 'source:\[BETA\] Inspect and manage a dataset'\''s datasources.'
1543
- 'view:\[BETA\] Inspect and manage saved views on a dataset.'
1604
+ 'list:List local dataset YAMLs under a path, or (no path) a workspace'\''s cloud datasets.'
1605
+ 'get:Print a dataset'\''s metadata and structure summary (local YAML path or cloud id).'
1606
+ 'query:Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
1607
+ 'create:Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
1608
+ 'delete:Permanently remove a dataset\: a local .dataset.yaml or a cloud dataset id.'
1609
+ 'source:Inspect and manage a dataset'\''s datasources.'
1610
+ 'view:Inspect and manage saved views on a dataset.'
1544
1611
  )
1545
1612
  _describe -t commands 'dataset command' sub
1546
1613
  }
@@ -1566,9 +1633,10 @@ _postman_dataset_get() {
1566
1633
  _postman_dataset_query() {
1567
1634
  _arguments \
1568
1635
  '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
1569
- '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
1636
+ '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
1570
1637
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1571
1638
  '--json[Output rows as JSON instead of a table]' \
1639
+ '--debug[Include safe classified dataset diagnostics]' \
1572
1640
  '(-h --help)'{-h,--help}'[display help for command]' \
1573
1641
  '*:datasetPathOrId:'
1574
1642
  }
@@ -1588,7 +1656,7 @@ _postman_dataset_create() {
1588
1656
  _postman_dataset_delete() {
1589
1657
  _arguments \
1590
1658
  '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
1591
- '--keep-resources[Delete only the YAML file; leave the .resources/ directory intact (local only)]' \
1659
+ '--keep-resources[Preserve the local resource directory even when it is empty (local only)]' \
1592
1660
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1593
1661
  '(-h --help)'{-h,--help}'[display help for command]' \
1594
1662
  '*:datasetPathOrId:'
@@ -1616,10 +1684,10 @@ _postman_dataset_source() {
1616
1684
  _postman_dataset_source_commands() {
1617
1685
  local -a sub
1618
1686
  sub=(
1619
- 'list:\[BETA\] List the datasources defined on a dataset (local YAML path or cloud id).'
1620
- 'add:\[BETA\] Add a datasource to a dataset.'
1621
- 'remove:\[BETA\] Remove a datasource from a dataset (local YAML path or cloud id).'
1622
- 'update:\[BETA\] Update fields on an existing datasource. Only the flags you provide are changed.'
1687
+ 'list:List the datasources defined on a dataset (local YAML path or cloud id).'
1688
+ 'add:Add a datasource to a dataset.'
1689
+ 'remove:Remove a datasource from a dataset (local YAML path or cloud id).'
1690
+ 'update:Update fields on an existing datasource. Only the flags you provide are changed.'
1623
1691
  )
1624
1692
  _describe -t commands 'source command' sub
1625
1693
  }
@@ -1634,25 +1702,38 @@ _postman_dataset_source_list() {
1634
1702
 
1635
1703
  _postman_dataset_source_add() {
1636
1704
  _arguments \
1637
- '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1705
+ '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to; positional target is also accepted for v1.45 compatibility]:datasetPathOrId' \
1638
1706
  '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
1639
- '--source-id[Override the generated source id]:uuid' \
1640
- '--format[Override the inferred format]:csv|json|mysql|postgres' \
1641
- '--type[Source kind; inferred from --file/--url when omitted]:local|remote-url|mysql|postgresql' \
1707
+ '--source-id[Override the generated source id (local dataset only)]:uuid' \
1708
+ '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
1709
+ '--type[Source kind; local is inferred when --file is provided]:local|mysql|postgresql|sqlserver' \
1642
1710
  '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
1643
1711
  '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
1644
1712
  '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
1645
1713
  '--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.]' \
1646
- '--url[HTTP(S) URL to a remote CSV/JSON file]:url' \
1647
- '--host[DB host (mysql/postgresql)]:host' \
1648
- '--port[DB port]:port' \
1714
+ '--host[DB host (mysql/postgresql/sqlserver)]:host' \
1715
+ '--port[DB port (defaults to 1433 for sqlserver)]:port' \
1649
1716
  '--user[DB user (warning\: stored as plaintext in the YAML).]:user' \
1650
1717
  '--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' \
1651
1718
  '--database[DB database name]:db' \
1652
- '--table[DB table name (optional)]:table' \
1653
- '--slug[Optional slug for the source]:slug' \
1719
+ '--table[DB table name (required for sqlserver)]:table' \
1720
+ '--ssh-host[SSH bastion host]:host' \
1721
+ '--ssh-port[SSH bastion port]:port' \
1722
+ '--ssh-user[SSH bastion user]:user' \
1723
+ '--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)"' \
1724
+ '--ssh-host-key[SSH bastion public host key]:publicKey' \
1725
+ '--ssh-host-key-vault-id[Shared Vault ID containing the SSH public host key]:id' \
1726
+ '--ssh-host-key-secret-id[Shared Vault secret ID containing the SSH public host key]:id' \
1727
+ '--ssh-insecure-skip-host-key-verification[WARNING\: disable SSH host-key verification; use only for trusted local testing]' \
1728
+ '--schema[DB schema (postgresql/sqlserver; defaults to dbo for sqlserver)]:schema' \
1729
+ '--encrypt[SQL Server TLS encryption (default\: true)]:true|false' \
1730
+ '--trust-server-certificate[SQL Server\: skip certificate verification (default\: false; insecure)]:true|false' \
1731
+ '--tls-certificate[SQL Server CA/server certificate file path]:path:_files -g "*.(pem|crt|key)"' \
1732
+ '--host-name-in-certificate[SQL Server certificate hostname override]:hostname' \
1733
+ '--tls-min-version[SQL Server minimum TLS version (default\: 1.2)]:1.2|1.3' \
1654
1734
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1655
- '(-h --help)'{-h,--help}'[display help for command]'
1735
+ '(-h --help)'{-h,--help}'[display help for command]' \
1736
+ '*:datasetPathOrId:'
1656
1737
  }
1657
1738
 
1658
1739
  _postman_dataset_source_remove() {
@@ -1667,18 +1748,30 @@ _postman_dataset_source_update() {
1667
1748
  _arguments \
1668
1749
  '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1669
1750
  '(-n --name)'{-n,--name}'[Rename the source]:name' \
1670
- '--format[Change the format]:csv|json|mysql|postgres' \
1671
- '--file[Replace the source'\''s file (local-filesystem only)]:path:_files -g "*.json"' \
1672
- '--ref-only[When using --file, reference in place instead of copying]' \
1673
- '--force[When copying with --file, overwrite existing destination]' \
1674
- '--url[Replace the remote URL (remote-url only)]:url' \
1675
- '--host[Update DB host (mysql/postgresql)]:host' \
1751
+ '--format[Change the format (local dataset only; cloud source formats are immutable)]:csv|json|mysql|postgres|sqlserver' \
1752
+ '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
1753
+ '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
1754
+ '--force[With --file, overwrite the copied destination (local dataset only)]' \
1755
+ '--host[Update DB host (mysql/postgresql/sqlserver)]:host' \
1676
1756
  '--port[Update DB port]:port' \
1677
1757
  '--user[Update DB user (warning\: stored as plaintext in the YAML).]:user' \
1678
1758
  '--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' \
1679
1759
  '--database[Update DB database name]:db' \
1680
1760
  '--table[Update DB table name]:table' \
1681
- '--slug[Update slug]:slug' \
1761
+ '--ssh-host[Update SSH bastion host]:host' \
1762
+ '--ssh-port[Update SSH bastion port]:port' \
1763
+ '--ssh-user[Update SSH bastion user]:user' \
1764
+ '--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)"' \
1765
+ '--ssh-host-key[Update the SSH bastion public host key]:publicKey' \
1766
+ '--ssh-host-key-vault-id[Update the Shared Vault ID containing the SSH public host key]:id' \
1767
+ '--ssh-host-key-secret-id[Update the Shared Vault secret ID containing the SSH public host key]:id' \
1768
+ '--ssh-insecure-skip-host-key-verification[WARNING\: disable SSH host-key verification; use only for trusted local testing]' \
1769
+ '--schema[Update DB schema (postgresql/sqlserver)]:schema' \
1770
+ '--encrypt[Update SQL Server TLS encryption]:true|false' \
1771
+ '--trust-server-certificate[Update SQL Server certificate verification (true is insecure)]:true|false' \
1772
+ '--tls-certificate[Update SQL Server CA/server certificate file path]:path:_files -g "*.(pem|crt|key)"' \
1773
+ '--host-name-in-certificate[Update SQL Server certificate hostname override]:hostname' \
1774
+ '--tls-min-version[Update SQL Server minimum TLS version]:1.2|1.3' \
1682
1775
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1683
1776
  '(-h --help)'{-h,--help}'[display help for command]' \
1684
1777
  '*:sourceNameOrId:'
@@ -1707,11 +1800,11 @@ _postman_dataset_view() {
1707
1800
  _postman_dataset_view_commands() {
1708
1801
  local -a sub
1709
1802
  sub=(
1710
- 'list:\[BETA\] List the saved views defined on a dataset (local YAML path or cloud id).'
1711
- 'run:\[BETA\] Execute a saved view against a dataset and print the rows.'
1712
- 'create:\[BETA\] Add a saved view to a dataset (local YAML path or cloud id).'
1713
- 'delete:\[BETA\] Remove a saved view from a dataset (local YAML path or cloud id).'
1714
- 'update:\[BETA\] Update name and/or query on an existing view (local YAML path or cloud id).'
1803
+ 'list:List the saved views defined on a dataset (local YAML path or cloud id).'
1804
+ 'run:Execute a saved view against a dataset and print the rows.'
1805
+ 'create:Add a saved view to a dataset (local YAML path or cloud id).'
1806
+ 'delete:Remove a saved view from a dataset (local YAML path or cloud id).'
1807
+ 'update:Update name and/or query on an existing view (local YAML path or cloud id).'
1715
1808
  )
1716
1809
  _describe -t commands 'view command' sub
1717
1810
  }
@@ -1727,9 +1820,10 @@ _postman_dataset_view_list() {
1727
1820
  _postman_dataset_view_run() {
1728
1821
  _arguments \
1729
1822
  '(-d --dataset)'{-d,--dataset}'[Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
1730
- '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
1823
+ '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
1731
1824
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1732
1825
  '--json[Output rows as JSON instead of a table]' \
1826
+ '--debug[Include safe classified dataset diagnostics]' \
1733
1827
  '(-h --help)'{-h,--help}'[display help for command]' \
1734
1828
  '*:viewNameOrId:'
1735
1829
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "postman-cli-completion",
3
- "version": "1.49.0",
3
+ "version": "1.52.0",
4
4
  "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
5
5
  "type": "module",
6
6
  "bin": {