postman-cli-completion 1.59.0 → 1.60.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.
@@ -1,4 +1,4 @@
1
- # Bash completion for Postman CLI (postman v1.59.0)
1
+ # Bash completion for Postman CLI (postman v1.60.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
@@ -91,7 +91,7 @@ _postman_login() {
91
91
 
92
92
  _postman_signup() {
93
93
  if [[ "$cur" == -* ]]; then
94
- COMPREPLY=( $(compgen -W "--browser --wait --no-wait --json -h --help" -- "$cur") )
94
+ COMPREPLY=( $(compgen -W "--guest --json -h --help" -- "$cur") )
95
95
  return 0
96
96
  fi
97
97
  }
@@ -127,7 +127,7 @@ _postman_whoami() {
127
127
 
128
128
  _postman_update() {
129
129
  if [[ "$cur" == -* ]]; then
130
- COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
130
+ COMPREPLY=( $(compgen -W "--check -h --help" -- "$cur") )
131
131
  return 0
132
132
  fi
133
133
  }
@@ -499,7 +499,7 @@ _postman_runner() {
499
499
 
500
500
  _postman_runner_start() {
501
501
  if [[ "$cur" == -* ]]; then
502
- 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") )
502
+ COMPREPLY=( $(compgen -W "--id --key --region --proxy --egress-proxy --egress-proxy-authz-url --ssl-extra-ca-certs --dataset-jdbc-driver-dir --metrics --metrics-port --report-events --no-report-events -h --help" -- "$cur") )
503
503
  return 0
504
504
  fi
505
505
  case "$prev" in
@@ -509,6 +509,9 @@ _postman_runner_start() {
509
509
  --ssl-extra-ca-certs)
510
510
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
511
511
  return 0 ;;
512
+ --dataset-jdbc-driver-dir)
513
+ COMPREPLY=( $(compgen -d -- "$cur") )
514
+ return 0 ;;
512
515
  esac
513
516
  }
514
517
 
@@ -731,7 +734,7 @@ _postman_monitor_run() {
731
734
 
732
735
  _postman_monitor_create() {
733
736
  if [[ "$cur" == -* ]]; then
734
- COMPREPLY=( $(compgen -W "-c --collection --name --environment -w --workspace --schedule --timezone --runner --notify-email --notification-limit --retry --timeout --delay --strict-ssl --insecure --follow-redirects --block-redirects --dataset-id --dataset-view-id --iteration-count --iteration-strategy --no-run-now --api-key --json -h --help" -- "$cur") )
737
+ COMPREPLY=( $(compgen -W "-c --collection --name -e --environment -w --workspace --schedule --timezone --runner --notify-email --notification-limit --retry --timeout --delay --strict-ssl --insecure --follow-redirects --block-redirects --dataset-id --dataset-view-id --iteration-count --iteration-strategy --no-run-now --api-key --json -h --help" -- "$cur") )
735
738
  return 0
736
739
  fi
737
740
  case "$prev" in
@@ -743,7 +746,7 @@ _postman_monitor_create() {
743
746
 
744
747
  _postman_monitor_update() {
745
748
  if [[ "$cur" == -* ]]; then
746
- COMPREPLY=( $(compgen -W "--name --schedule --timezone --runner --notify-email --clear-notifications --notification-limit --retry --timeout --delay --strict-ssl --insecure --follow-redirects --block-redirects --dataset-id --dataset-view-id --iteration-count --iteration-strategy --api-key --json -h --help" -- "$cur") )
749
+ COMPREPLY=( $(compgen -W "--name --schedule --timezone --runner --notify-email --clear-notifications -e --environment --clear-environment --notification-limit --retry --timeout --delay --strict-ssl --insecure --follow-redirects --block-redirects --dataset-id --dataset-view-id --iteration-count --iteration-strategy --api-key --json -h --help" -- "$cur") )
747
750
  return 0
748
751
  fi
749
752
  case "$prev" in
@@ -832,7 +835,7 @@ _postman_monitor_runs_get() {
832
835
 
833
836
  _postman_monitor_list() {
834
837
  if [[ "$cur" == -* ]]; then
835
- COMPREPLY=( $(compgen -W "--api-key -w --workspace -c --collection --environment --runner --owner --team --active --limit --offset --cursor --columns --no-headers -f --filter --sort --json -h --help" -- "$cur") )
838
+ COMPREPLY=( $(compgen -W "--api-key -w --workspace -c --collection -e --environment --runner --owner --team --active --limit --cursor --columns --no-headers -f --filter --sort --json -h --help" -- "$cur") )
836
839
  return 0
837
840
  fi
838
841
  case "$prev" in
@@ -895,7 +898,7 @@ _postman_workspace() {
895
898
  if [[ "$cur" == -* ]]; then
896
899
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
897
900
  else
898
- COMPREPLY=( $(compgen -W "list prepare push lint create pull connect-git diff" -- "$cur") )
901
+ COMPREPLY=( $(compgen -W "list prepare push lint get create pull connect-git diff" -- "$cur") )
899
902
  fi
900
903
  return 0
901
904
  fi
@@ -904,6 +907,7 @@ _postman_workspace() {
904
907
  prepare) _postman_workspace_prepare ;;
905
908
  push) _postman_workspace_push ;;
906
909
  lint) _postman_workspace_lint ;;
910
+ get) _postman_workspace_get ;;
907
911
  create) _postman_workspace_create ;;
908
912
  pull) _postman_workspace_pull ;;
909
913
  connect-git) _postman_workspace_connect_git ;;
@@ -945,6 +949,15 @@ _postman_workspace_lint() {
945
949
  esac
946
950
  }
947
951
 
952
+ _postman_workspace_get() {
953
+ if [[ "$cur" == -* ]]; then
954
+ COMPREPLY=( $(compgen -W "--elements --json --timeout -h --help" -- "$cur") )
955
+ return 0
956
+ fi
957
+ case "$prev" in
958
+ esac
959
+ }
960
+
948
961
  _postman_workspace_create() {
949
962
  if [[ "$cur" == -* ]]; then
950
963
  COMPREPLY=( $(compgen -W "--visibility --name --summary --path --no-connect --force -h --help" -- "$cur") )
@@ -988,13 +1001,13 @@ _postman_performance() {
988
1001
  if [[ "$cur" == -* ]]; then
989
1002
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
990
1003
  else
991
- COMPREPLY=( $(compgen -W "run runs" -- "$cur") )
1004
+ COMPREPLY=( $(compgen -W "run list" -- "$cur") )
992
1005
  fi
993
1006
  return 0
994
1007
  fi
995
1008
  case "$subcmd" in
996
1009
  run) _postman_performance_run ;;
997
- runs) _postman_performance_runs ;;
1010
+ list) _postman_performance_list ;;
998
1011
  esac
999
1012
  }
1000
1013
 
@@ -1011,7 +1024,7 @@ _postman_performance_run() {
1011
1024
  _postman_filematch '!*.@(json)' "$cur"
1012
1025
  }
1013
1026
 
1014
- _postman_performance_runs() {
1027
+ _postman_performance_list() {
1015
1028
  if [[ "$cur" == -* ]]; then
1016
1029
  COMPREPLY=( $(compgen -W "-c --collection-id --cursor --json --timeout -h --help" -- "$cur") )
1017
1030
  return 0
@@ -1961,7 +1974,7 @@ _postman_dataset() {
1961
1974
  if [[ "$cur" == -* ]]; then
1962
1975
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
1963
1976
  else
1964
- COMPREPLY=( $(compgen -W "list get query create delete source view" -- "$cur") )
1977
+ COMPREPLY=( $(compgen -W "list get query create delete source view jdbc" -- "$cur") )
1965
1978
  fi
1966
1979
  return 0
1967
1980
  fi
@@ -1973,6 +1986,7 @@ _postman_dataset() {
1973
1986
  delete) _postman_dataset_delete ;;
1974
1987
  source) _postman_dataset_source ;;
1975
1988
  view) _postman_dataset_view ;;
1989
+ jdbc) _postman_dataset_jdbc ;;
1976
1990
  esac
1977
1991
  }
1978
1992
 
@@ -2043,7 +2057,7 @@ _postman_dataset_source() {
2043
2057
  if [[ "$cur" == -* ]]; then
2044
2058
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
2045
2059
  else
2046
- COMPREPLY=( $(compgen -W "list add remove update" -- "$cur") )
2060
+ COMPREPLY=( $(compgen -W "list add remove update test" -- "$cur") )
2047
2061
  fi
2048
2062
  return 0
2049
2063
  fi
@@ -2052,6 +2066,7 @@ _postman_dataset_source() {
2052
2066
  add) _postman_dataset_source_add ;;
2053
2067
  remove) _postman_dataset_source_remove ;;
2054
2068
  update) _postman_dataset_source_update ;;
2069
+ test) _postman_dataset_source_test ;;
2055
2070
  esac
2056
2071
  }
2057
2072
 
@@ -2069,13 +2084,22 @@ _postman_dataset_source_list() {
2069
2084
 
2070
2085
  _postman_dataset_source_add() {
2071
2086
  if [[ "$cur" == -* ]]; then
2072
- 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") )
2087
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name --source-id --format --type --file --ref-only --force --upload --driver-jar --driver-class --driver-name --url-template --var --prop --vars-file --from-source --java-path --no-test --ssh-target-host-variable --ssh-target-port-variable --json --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") )
2073
2088
  return 0
2074
2089
  fi
2075
2090
  case "$prev" in
2076
2091
  --file)
2077
2092
  _postman_filematch '!*.@(json)' "$cur"
2078
2093
  return 0 ;;
2094
+ --driver-jar)
2095
+ _postman_filematch '!*.@(json)' "$cur"
2096
+ return 0 ;;
2097
+ --vars-file)
2098
+ _postman_filematch '!*.@(json)' "$cur"
2099
+ return 0 ;;
2100
+ --java-path)
2101
+ _postman_filematch '!*.@(json)' "$cur"
2102
+ return 0 ;;
2079
2103
  --ssh-private-key)
2080
2104
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
2081
2105
  return 0 ;;
@@ -2102,13 +2126,22 @@ _postman_dataset_source_remove() {
2102
2126
 
2103
2127
  _postman_dataset_source_update() {
2104
2128
  if [[ "$cur" == -* ]]; then
2105
- 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") )
2129
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name --format --file --ref-only --force --driver-jar --driver-class --driver-name --url-template --var --prop --unset-var --unset-prop --vars-file --ssh-target-host-variable --ssh-target-port-variable --java-path --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 --json -h --help" -- "$cur") )
2106
2130
  return 0
2107
2131
  fi
2108
2132
  case "$prev" in
2109
2133
  --file)
2110
2134
  _postman_filematch '!*.@(json)' "$cur"
2111
2135
  return 0 ;;
2136
+ --driver-jar)
2137
+ _postman_filematch '!*.@(json)' "$cur"
2138
+ return 0 ;;
2139
+ --vars-file)
2140
+ _postman_filematch '!*.@(json)' "$cur"
2141
+ return 0 ;;
2142
+ --java-path)
2143
+ _postman_filematch '!*.@(json)' "$cur"
2144
+ return 0 ;;
2112
2145
  --ssh-private-key)
2113
2146
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
2114
2147
  return 0 ;;
@@ -2121,6 +2154,21 @@ _postman_dataset_source_update() {
2121
2154
  esac
2122
2155
  }
2123
2156
 
2157
+ _postman_dataset_source_test() {
2158
+ if [[ "$cur" == -* ]]; then
2159
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name --java-path --api-key --json -h --help" -- "$cur") )
2160
+ return 0
2161
+ fi
2162
+ case "$prev" in
2163
+ --java-path)
2164
+ _postman_filematch '!*.@(json)' "$cur"
2165
+ return 0 ;;
2166
+ --api-key)
2167
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
2168
+ return 0 ;;
2169
+ esac
2170
+ }
2171
+
2124
2172
  _postman_dataset_view() {
2125
2173
  if [[ -z "$subcmd" ]]; then
2126
2174
  if [[ "$cur" == -* ]]; then
@@ -2165,7 +2213,7 @@ _postman_dataset_view_run() {
2165
2213
 
2166
2214
  _postman_dataset_view_create() {
2167
2215
  if [[ "$cur" == -* ]]; then
2168
- COMPREPLY=( $(compgen -W "-d --dataset -n --name -q --query --view-id --api-key -h --help" -- "$cur") )
2216
+ COMPREPLY=( $(compgen -W "-d --dataset -n --name -q --query -s --source --view-id --json --api-key -h --help" -- "$cur") )
2169
2217
  return 0
2170
2218
  fi
2171
2219
  case "$prev" in
@@ -2199,6 +2247,32 @@ _postman_dataset_view_update() {
2199
2247
  esac
2200
2248
  }
2201
2249
 
2250
+ _postman_dataset_jdbc() {
2251
+ if [[ -z "$subcmd" ]]; then
2252
+ if [[ "$cur" == -* ]]; then
2253
+ COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
2254
+ else
2255
+ COMPREPLY=( $(compgen -W "inspect" -- "$cur") )
2256
+ fi
2257
+ return 0
2258
+ fi
2259
+ case "$subcmd" in
2260
+ inspect) _postman_dataset_jdbc_inspect ;;
2261
+ esac
2262
+ }
2263
+
2264
+ _postman_dataset_jdbc_inspect() {
2265
+ if [[ "$cur" == -* ]]; then
2266
+ COMPREPLY=( $(compgen -W "--driver-class --url-template --java-path --json -h --help" -- "$cur") )
2267
+ return 0
2268
+ fi
2269
+ case "$prev" in
2270
+ --java-path)
2271
+ _postman_filematch '!*.@(json)' "$cur"
2272
+ return 0 ;;
2273
+ esac
2274
+ }
2275
+
2202
2276
  _postman_dependency() {
2203
2277
  if [[ -z "$subcmd" ]]; then
2204
2278
  if [[ "$cur" == -* ]]; then
@@ -1,4 +1,4 @@
1
- # Fish completion for Postman CLI (postman v1.59.0)
1
+ # Fish completion for Postman CLI (postman v1.60.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
@@ -32,7 +32,7 @@ complete -c postman -n __postman_no_subcommand -a collection -d 'Run and test yo
32
32
  complete -c postman -n __postman_no_subcommand -a environment -d 'Work with local Postman environments from the command line. Also read cloud environments by ID.'
33
33
  complete -c postman -n __postman_no_subcommand -a globals -d 'Work with local Postman globals from the command line.'
34
34
  complete -c postman -n __postman_no_subcommand -a api -d 'Publish and test your APIs directly from the command line'
35
- complete -c postman -n __postman_no_subcommand -a runner -d 'Where your monitors execute: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team'
35
+ complete -c postman -n __postman_no_subcommand -a runner -d 'Where your monitors execute: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team.'
36
36
  complete -c postman -n __postman_no_subcommand -a spec -d 'Lint and validate Specifications from the command line'
37
37
  complete -c postman -n __postman_no_subcommand -a monitor -d 'Run and manage Postman monitors.'
38
38
  complete -c postman -n __postman_no_subcommand -a workspace -d 'Manage workspace resources.'
@@ -61,9 +61,7 @@ complete -c postman -n '__fish_seen_subcommand_from login' -l verbose -d 'Show d
61
61
  complete -c postman -n '__fish_seen_subcommand_from login' -s h -l help -d 'display help for command'
62
62
 
63
63
  # ---------- signup ----------
64
- complete -c postman -n '__fish_seen_subcommand_from signup' -l browser -d 'Always open the sign-up URL in a browser here, rather than printing it.'
65
- complete -c postman -n '__fish_seen_subcommand_from signup' -l wait -d 'Wait for the sign-up to complete even if no local browser is detected.'
66
- complete -c postman -n '__fish_seen_subcommand_from signup' -l no-wait -d 'Print the sign-up URL and exit without waiting. Leaves this CLI a guest.'
64
+ complete -c postman -n '__fish_seen_subcommand_from signup' -l guest -d 'Start working as an anonymous guest instead of signing up — no account or browser needed, so it works anywhere. Your work is saved to a temporary workspace you can keep later by running `postman signup`.'
67
65
  complete -c postman -n '__fish_seen_subcommand_from signup' -l json -d 'Print the sign-up details as machine-readable JSON.'
68
66
  complete -c postman -n '__fish_seen_subcommand_from signup' -s h -l help -d 'display help for command'
69
67
 
@@ -87,6 +85,7 @@ complete -c postman -n '__fish_seen_subcommand_from whoami' -l json -d 'Print cu
87
85
  complete -c postman -n '__fish_seen_subcommand_from whoami' -s h -l help -d 'display help for command'
88
86
 
89
87
  # ---------- update ----------
88
+ complete -c postman -n '__fish_seen_subcommand_from update' -l check -d 'Check whether a Postman CLI update is available.'
90
89
  complete -c postman -n '__fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
91
90
 
92
91
  # ---------- skills ----------
@@ -284,22 +283,23 @@ complete -c postman -n '__fish_seen_subcommand_from api; and __fish_seen_subcomm
284
283
  complete -c postman -n '__fish_seen_subcommand_from api; and __fish_seen_subcommand_from publish' -s h -l help -d 'display help for command'
285
284
 
286
285
  # ---------- runner ----------
287
- complete -c postman -n '__postman_using_subcommand runner start list regions' -a start -d 'Start a runner'
288
- complete -c postman -n '__postman_using_subcommand runner start list regions' -a list -d 'List the team\'s registered self-hosted runners'
289
- complete -c postman -n '__postman_using_subcommand runner start list regions' -a regions -d 'List the region and private-runner values valid for monitor create/update --runner, including a static IP where configured'
286
+ complete -c postman -n '__postman_using_subcommand runner start list regions' -a start -d 'Start a self-hosted runner in your own network.'
287
+ complete -c postman -n '__postman_using_subcommand runner start list regions' -a list -d 'List the team\'s registered self-hosted runners.'
288
+ complete -c postman -n '__postman_using_subcommand runner start list regions' -a regions -d 'List the region and private-runner values valid for monitor create/update --runner, with the static IP Postman runs each one from, where your team has access to it.'
290
289
  complete -c postman -n '__fish_seen_subcommand_from runner' -s h -l help -d 'display help for command'
291
290
  # ---------- runner start ----------
292
291
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l id -d 'The ID of the runner to execute' -x
293
292
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l key -d 'The secret key for the runner' -r
294
- complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l region -d 'Specify the region for the runner. Use "eu" for EU region.' -x
295
- complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l proxy -d 'External proxy URL (e.g., http://proxy.com or http://proxy.com:8080)' -x
293
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l region -d 'Region this runner reports to -- use "eu" for the EU region' -x
294
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l proxy -d 'External proxy URL, for example http://proxy.com or http://proxy.com:8080' -x
296
295
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l egress-proxy -d 'Enable built-in egress proxy'
297
296
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l egress-proxy-authz-url -d 'Custom egress proxy authorization service base URL' -x
298
297
  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
298
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l dataset-jdbc-driver-dir -d 'Folder on this machine holding the JDBC driver .jar files you put there. Required to run a dataset that uses a JDBC source. Drivers are loaded only from this folder and matched by file name; driver paths saved in the dataset are ignored' -x
299
299
  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'
300
300
  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
301
- 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'
302
- 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'
301
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l report-events -d 'Accepted for compatibility; run events are reported by default'
302
+ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -l no-report-events -d 'Do not report run events to Postman'
303
303
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -s h -l help -d 'display help for command'
304
304
  # ---------- runner list ----------
305
305
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
@@ -395,7 +395,7 @@ complete -c postman -n '__postman_using_subcommand monitor run create update del
395
395
  complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a resume -d 'Resume a paused monitor, so it fires on schedule again.'
396
396
  complete -c postman -n '__fish_seen_subcommand_from monitor' -s h -l help -d 'display help for command'
397
397
  # ---------- monitor run ----------
398
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
398
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
399
399
  complete -c postman -n '__fish_seen_subcommand_from monitor; 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'
400
400
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -s t -l timeout -d 'Maximum wait time for run completion in milliseconds (default: 15 minutes) (default: 900000)' -x
401
401
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -l async -d 'Submit the run and return immediately with its job id and Postman URL, without waiting for completion'
@@ -404,14 +404,14 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
404
404
  # ---------- monitor create ----------
405
405
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -s c -l collection -d 'Collection to monitor -- accepts the id shown in the Postman app, prefixed or bare' -x
406
406
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l name -d 'Monitor name (defaults to the linked collection\'s own name)' -x
407
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l environment -d 'Environment to run the monitored collection with' -x
407
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -s e -l environment -d 'Environment to run the monitored collection with' -x
408
408
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -s w -l workspace -d 'Workspace to create the monitor in (defaults to the workspace named in the local .postman/resources.yaml manifest; required if neither is available)' -x
409
409
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l schedule -d 'Cron expression for the monitor\'s schedule' -x
410
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l timezone -d 'Time zone for --schedule, e.g. America/New_York (defaults to the host machine\'s own zone)' -x
410
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l timezone -d 'Time zone for --schedule, for example America/New_York (defaults to the host machine\'s own zone)' -x
411
411
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l runner -d 'A Postman region name (see `postman runner regions`) or the id of a self-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable) (default: [])' -x
412
412
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l notify-email -d 'Email to notify on a run failure or error (repeatable) (default: [])' -x
413
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l notification-limit -d 'Cap consecutive notifications before they are muted (service range: 1-99)' -x
414
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l retry -d 'Retries on a failed run (service caps this at 2)' -x
413
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l notification-limit -d 'Consecutive failure notifications to send before muting them' -x
414
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l retry -d 'Times to retry a failed run' -x
415
415
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l timeout -d 'Request timeout in milliseconds' -x
416
416
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l delay -d 'Delay between requests in milliseconds' -x
417
417
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l strict-ssl -d 'Fail the run when the target\'s TLS certificate cannot be verified'
@@ -421,7 +421,7 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
421
421
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l dataset-id -d 'Dataset to use as iteration data (used together with --dataset-view-id)' -x
422
422
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l dataset-view-id -d 'Dataset view to iterate (used together with --dataset-id)' -x
423
423
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l iteration-count -d 'Number of iterations to run' -x
424
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l iteration-strategy -d 'How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)' -x
424
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l iteration-strategy -d 'How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)' -x
425
425
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l no-run-now -d 'Do not trigger an immediate run after creating the monitor'
426
426
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
427
427
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from create' -l json -d 'Output as JSON instead of a table'
@@ -429,12 +429,14 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
429
429
  # ---------- monitor update ----------
430
430
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l name -d 'New monitor name' -x
431
431
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l schedule -d 'New cron expression for the monitor\'s schedule' -x
432
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l timezone -d 'Time zone for --schedule, e.g. America/New_York (defaults to the host machine\'s own zone)' -x
432
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l timezone -d 'Time zone for --schedule, for example America/New_York (defaults to the host machine\'s own zone)' -x
433
433
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l runner -d 'A Postman region name (see `postman runner regions`) or the id of a self-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable; replaces the current set) (default: [])' -x
434
434
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l notify-email -d 'Email to notify on a run failure or error (repeatable; replaces the current list) (default: [])' -x
435
435
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l clear-notifications -d 'Remove every notification recipient'
436
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l notification-limit -d 'Cap consecutive notifications before they are muted (service range: 1-99)' -x
437
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l retry -d 'Retries on a failed run (service caps this at 2)' -x
436
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -s e -l environment -d 'Environment to run the monitored collection with (replaces the current one)' -x
437
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l clear-environment -d 'Run the monitored collection with no environment'
438
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l notification-limit -d 'Consecutive failure notifications to send before muting them' -x
439
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l retry -d 'Times to retry a failed run' -x
438
440
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l timeout -d 'Request timeout in milliseconds' -x
439
441
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l delay -d 'Delay between requests in milliseconds' -x
440
442
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l strict-ssl -d 'Fail the run when the target\'s TLS certificate cannot be verified'
@@ -444,7 +446,7 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
444
446
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l dataset-id -d 'Dataset to use as iteration data (used together with --dataset-view-id)' -x
445
447
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l dataset-view-id -d 'Dataset view to iterate (used together with --dataset-id)' -x
446
448
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l iteration-count -d 'Number of iterations to run' -x
447
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l iteration-strategy -d 'How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)' -x
449
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l iteration-strategy -d 'How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)' -x
448
450
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
449
451
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -l json -d 'Output as JSON instead of a table'
450
452
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
@@ -458,24 +460,24 @@ complete -c postman -n '__postman_using_subcommand jobs list get' -a list -d 'Li
458
460
  complete -c postman -n '__postman_using_subcommand jobs list get' -a get -d 'Report one job\'s terminal state and its per-region run outcomes.'
459
461
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs' -s h -l help -d 'display help for command'
460
462
  # ---------- monitor jobs list ----------
461
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
462
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l result -d 'Filter by outcome, e.g. success, failure, error, abort (server-validated, not a fixed list)' -x
463
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l trigger -d 'Filter by trigger, e.g. api, schedule, webhook, postman-cli (server-validated, not a fixed list)' -x
463
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
464
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l result -d 'Filter by outcome, for example success, failure, error or abort' -x
465
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l trigger -d 'Filter by trigger, for example api, schedule, webhook or postman-cli' -x
464
466
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l since -d 'Only jobs that finished at or after this ISO 8601 date-time' -x
465
467
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l limit -d 'Maximum number of jobs to return' -x
466
468
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l cursor -d 'Opaque pagination cursor' -x
467
469
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -l json -d 'Output as JSON instead of a table'
468
470
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
469
471
  # ---------- monitor jobs get ----------
470
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
472
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
471
473
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from get' -l json -d 'Output as JSON instead of a table'
472
474
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from jobs; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
473
475
  # ---------- monitor runs ----------
474
476
  complete -c postman -n '__postman_using_subcommand runs get' -a get -d 'Report which test assertions ran during one attempt of a run, which failed, and why.'
475
477
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs' -s h -l help -d 'display help for command'
476
478
  # ---------- monitor runs get ----------
477
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
478
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l attempt -d 'Which attempt of the run to show, counting from 0 (default: the latest)' -x
479
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
480
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l attempt -d 'Which attempt of the run to show, where 0 is the first (default: the most recent)' -x
479
481
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l failed-only -d 'Show only failed assertions'
480
482
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -l json -d 'Output as JSON instead of a table'
481
483
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from runs; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
@@ -483,15 +485,14 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
483
485
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
484
486
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Filter to monitors in this workspace' -x
485
487
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -s c -l collection -d 'Filter to monitors on this collection' -x
486
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l environment -d 'Filter to monitors on this environment' -x
487
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l runner -d 'Filter to a Self-Hosted Runner ID (not a Postman Region). Cannot be combined with --workspace, --collection, --environment, --owner, --team or --active.' -x
488
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -s e -l environment -d 'Filter to monitors on this environment' -x
489
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l runner -d 'Filter to a self-hosted runner id, not a Postman region. Cannot be combined with --workspace, --collection, --environment, --owner, --team or --active' -x
488
490
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l owner -d 'Filter to monitors created by this user id (shown in the Owner column)' -x
489
491
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l team -d 'Filter to monitors owned by your own team'
490
492
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l active -d 'Filter by active state' -x
491
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l limit -d 'Max monitors to return. The service caps page size and rejects a value above it with its own error.' -x
492
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l offset -d 'Not supported: the service accepts this parameter and silently ignores it. Refused locally. Use --cursor instead.' -x
493
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l cursor -d 'Pagination cursor from a previous page\'s response.' -x
494
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l columns -d 'Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available: State, Notifications, Environment, Runners.' -x
493
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l limit -d 'Maximum number of monitors to return (Postman caps the page size and rejects a larger value)' -x
494
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l cursor -d 'Pagination cursor from a previous page\'s response' -x
495
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l columns -d 'Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available: State, Notifications, Environment, Runners' -x
495
496
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l no-headers -d 'Omit the header row'
496
497
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -s f -l filter -d 'Show only monitors whose name contains this text (applies to the returned page, case-insensitive)' -x
497
498
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from list' -l sort -d 'Sort the returned page by "name" or "active"' -x
@@ -503,10 +504,10 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
503
504
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
504
505
  # ---------- monitor metrics ----------
505
506
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
506
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l since -d 'Only executions at or after this ISO 8601 date-time. Defaults to 7 days ago.' -x
507
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l until -d 'Only executions at or before this ISO 8601 date-time. Defaults to now.' -x
507
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l since -d 'Only executions at or after this ISO 8601 date-time (defaults to 7 days ago)' -x
508
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l until -d 'Only executions at or before this ISO 8601 date-time (defaults to now)' -x
508
509
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -s f -l filter -d 'Show only requests whose name contains this text (case-insensitive)' -x
509
- complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l limit -d 'Cap the number of rows shown: executions (newest first) under --json, or table rows (worst-behaving request first) otherwise. Not honoured by the service -- there is no server-side pagination on this route.' -x
510
+ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l limit -d 'Maximum number of rows to show: executions, newest first, under --json, or requests, worst-behaving first, in the table. Applied to the results after they are fetched, so it does not make the command faster' -x
510
511
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l json -d 'Output as JSON instead of a table'
511
512
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -s h -l help -d 'display help for command'
512
513
  # ---------- monitor pause ----------
@@ -519,14 +520,15 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
519
520
  complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from resume' -s h -l help -d 'display help for command'
520
521
 
521
522
  # ---------- workspace ----------
522
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a list -d 'List all available Postman Workspaces'
523
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
524
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a push -d 'Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
525
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -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.'
526
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a create -d 'Create a Postman workspace and bind it to this git repository.'
527
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a pull -d 'Pull workspace entities from a Postman workspace into the local git-native folder.'
528
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a connect-git -d 'Connect a Postman workspace to a local git repository.'
529
- complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a diff -d 'Preview local-vs-cloud drift before pushing. Read-only: nothing is created, updated or deleted.'
523
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a list -d 'List all available Postman Workspaces'
524
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
525
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a push -d 'Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
526
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -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.'
527
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a get -d 'Read a workspace\'s metadata, and optionally the ids of what it holds.'
528
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a create -d 'Create a Postman workspace and bind it to this git repository.'
529
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a pull -d 'Pull workspace entities from a Postman workspace into the local git-native folder.'
530
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a connect-git -d 'Connect a Postman workspace to a local git repository.'
531
+ complete -c postman -n '__postman_using_subcommand workspace list prepare push lint get create pull connect-git diff' -a diff -d 'Preview local-vs-cloud drift before pushing. Read-only: nothing is created, updated or deleted.'
530
532
  complete -c postman -n '__fish_seen_subcommand_from workspace' -s h -l help -d 'display help for command'
531
533
  # ---------- workspace list ----------
532
534
  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
@@ -553,6 +555,11 @@ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_s
553
555
  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
554
556
  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.'
555
557
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
558
+ # ---------- workspace get ----------
559
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from get' -l elements -d 'Also report the resources the workspace holds.'
560
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from get' -l json -d 'Print the workspace as machine-readable JSON.'
561
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from get' -l timeout -d 'Milliseconds to wait for the API (default 30000).' -x
562
+ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
556
563
  # ---------- workspace create ----------
557
564
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l visibility -d 'Required. Workspace visibility, e.g. personal or team' -x
558
565
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l name -d 'Workspace name (defaults to owner/repo from the git remote)' -x
@@ -580,8 +587,8 @@ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_s
580
587
  complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -s h -l help -d 'display help for command'
581
588
 
582
589
  # ---------- performance ----------
583
- complete -c postman -n '__postman_using_subcommand performance run runs' -a run -d 'Run a performance test on a collection'
584
- complete -c postman -n '__postman_using_subcommand performance run runs' -a runs -d 'List past performance runs for a collection, newest first.'
590
+ complete -c postman -n '__postman_using_subcommand performance run list' -a run -d 'Run a performance test on a collection'
591
+ complete -c postman -n '__postman_using_subcommand performance run list' -a list -d 'List past performance runs for a collection, newest first.'
585
592
  complete -c postman -n '__fish_seen_subcommand_from performance' -s h -l help -d 'display help for command'
586
593
  # ---------- performance run ----------
587
594
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s e -l environment -d 'Specify an Id to a Postman Environment' -x
@@ -601,12 +608,12 @@ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen
601
608
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l use-mock -d 'Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format: "<{{var}}|host> mock|mock-server:<path|id> [scenario]" (default: [])' -x
602
609
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
603
610
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
604
- # ---------- performance runs ----------
605
- complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -s c -l collection-id -d 'Collection ID whose performance runs to list' -x
606
- complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l cursor -d 'Pagination cursor from a previous page\'s response' -x
607
- complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l json -d 'Output as JSON instead of a table'
608
- complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l timeout -d 'Milliseconds to wait for the service before failing (default: "30000")' -x
609
- complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -s h -l help -d 'display help for command'
611
+ # ---------- performance list ----------
612
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from list' -s c -l collection-id -d 'Collection ID whose performance runs to list' -x
613
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from list' -l cursor -d 'Pagination cursor from a previous page\'s response' -x
614
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from list' -l json -d 'Output as JSON instead of a table'
615
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from list' -l timeout -d 'Milliseconds to wait for the service before failing (default: "30000")' -x
616
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
610
617
 
611
618
  # ---------- flows ----------
612
619
  complete -c postman -n '__postman_using_subcommand flows list trigger deploy run update list-runs get-run' -a list -d 'List all flows'
@@ -1102,13 +1109,14 @@ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_sub
1102
1109
  complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from forward' -s h -l help -d 'display help for command'
1103
1110
 
1104
1111
  # ---------- dataset ----------
1105
- 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.'
1106
- 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).'
1107
- 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).'
1108
- 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.'
1109
- 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.'
1110
- 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.'
1111
- 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.'
1112
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a list -d 'List local dataset YAMLs under a path, or (no path) a workspace\'s cloud datasets.'
1113
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a get -d 'Print a dataset\'s metadata and structure summary (local YAML path or cloud id).'
1114
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a query -d 'Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
1115
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a create -d 'Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
1116
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a delete -d 'Permanently remove a dataset: a local .dataset.yaml or a cloud dataset id.'
1117
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a source -d 'Inspect and manage a dataset\'s datasources.'
1118
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a view -d 'Inspect and manage saved views on a dataset.'
1119
+ complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view jdbc' -a jdbc -d 'Inspect JDBC drivers before attaching one to a dataset.'
1112
1120
  complete -c postman -n '__fish_seen_subcommand_from dataset' -s h -l help -d 'display help for command'
1113
1121
  # ---------- dataset list ----------
1114
1122
  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
@@ -1144,10 +1152,11 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1144
1152
  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
1145
1153
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
1146
1154
  # ---------- dataset source ----------
1147
- 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).'
1148
- complete -c postman -n '__postman_using_subcommand source list add remove update' -a add -d 'Add a datasource to a dataset.'
1149
- 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).'
1150
- 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.'
1155
+ complete -c postman -n '__postman_using_subcommand source list add remove update test' -a list -d 'List the datasources defined on a dataset (local YAML path or cloud id).'
1156
+ complete -c postman -n '__postman_using_subcommand source list add remove update test' -a add -d 'Add a datasource to a dataset.'
1157
+ complete -c postman -n '__postman_using_subcommand source list add remove update test' -a remove -d 'Remove a datasource from a dataset (local YAML path or cloud id).'
1158
+ complete -c postman -n '__postman_using_subcommand source list add remove update test' -a update -d 'Update fields on an existing datasource. Only the flags you provide are changed.'
1159
+ complete -c postman -n '__postman_using_subcommand source list add remove update test' -a test -d 'Open and close a real connection using a source\'s stored configuration.'
1151
1160
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source' -s h -l help -d 'display help for command'
1152
1161
  # ---------- dataset source list ----------
1153
1162
  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
@@ -1159,15 +1168,28 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1159
1168
  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
1160
1169
  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
1161
1170
  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
1162
- 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
1171
+ 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 from --file, jdbc from --driver-jar' -x
1163
1172
  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
1164
1173
  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)'
1165
1174
  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)'
1166
1175
  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.'
1176
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-jar -d 'JDBC driver JAR(s). Repeatable, or pass several after one flag' -r
1177
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-class -d 'Driver class. Auto-resolved when the JAR contains exactly one' -x
1178
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-name -d 'Label for this driver type (defaults to the JAR filename)' -x
1179
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l url-template -d 'JDBC URL with {{placeholders}}, e.g. jdbc:postgresql://{{host}}:{{port}}/{{database}}' -x
1180
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l var -d 'Value for a {{placeholder}}. Repeatable. Use vault:<vaultId>/<secretId> for a secret. WARNING: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1181
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l prop -d 'Driver connection property. Repeatable. Same vault: syntax as --var' -x
1182
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l vars-file -d 'JSON object of --var values; "-" reads stdin. Supports {"$vaultId":..,"$secretId":..} objects, and keeps secrets out of argv entirely' -r
1183
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l from-source -d 'Reuse another source\'s driver JAR, class and URL template' -x
1184
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l java-path -d 'Java runtime to use. Machine-local only - never written to the dataset. Also read from POSTMAN_JDBC_JAVA_PATH' -r
1185
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l no-test -d 'Skip the pre-write connection test. Note that resolving the driver class still starts a JVM — on a machine with no Java, pass --driver-class (or --from-source) too'
1186
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-target-host-variable -d 'Template variable holding the tunnelled host (inferred when omitted)' -x
1187
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ssh-target-port-variable -d 'Template variable holding the tunnelled port (inferred when omitted)' -x
1188
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l json -d 'Emit the result as JSON instead of prose'
1167
1189
  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
1168
1190
  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
1169
- 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
1170
- 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
1191
+ 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: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1192
+ 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: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1171
1193
  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
1172
1194
  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
1173
1195
  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
@@ -1197,10 +1219,22 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1197
1219
  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
1198
1220
  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)'
1199
1221
  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)'
1222
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l driver-jar -d 'Replace the JDBC driver JAR(s)' -r
1223
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l driver-class -d 'Replace the JDBC driver class' -x
1224
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l driver-name -d 'Rename the JDBC driver type label' -x
1225
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l url-template -d 'Replace the JDBC URL template' -x
1226
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l var -d 'Set a JDBC template variable. Merges onto the existing values. Use vault:<vaultId>/<secretId> for a secret. WARNING: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1227
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l prop -d 'Set a JDBC connection property. Merges, same vault: syntax' -x
1228
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l unset-var -d 'Remove a JDBC template variable. Merging alone can never remove a key' -x
1229
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l unset-prop -d 'Remove a JDBC connection property' -x
1230
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l vars-file -d 'JSON object of --var values; "-" reads stdin' -r
1231
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-target-host-variable -d 'Template variable holding the tunnelled host (JDBC)' -x
1232
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ssh-target-port-variable -d 'Template variable holding the tunnelled port (JDBC)' -x
1233
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l java-path -d 'Java runtime for JDBC operations. Machine-local only' -r
1200
1234
  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
1201
1235
  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
1202
- 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
1203
- 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
1236
+ 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: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1237
+ 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: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.' -x
1204
1238
  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
1205
1239
  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
1206
1240
  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
@@ -1218,7 +1252,15 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1218
1252
  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
1219
1253
  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
1220
1254
  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
1255
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l json -d 'Emit the result as JSON instead of prose'
1221
1256
  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'
1257
+ # ---------- dataset source test ----------
1258
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -s d -l dataset -d 'Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id' -x
1259
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -s n -l name -d 'Source to test' -x
1260
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -l java-path -d 'Java runtime to use for a JDBC source. Machine-local only; also read from POSTMAN_JDBC_JAVA_PATH' -r
1261
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
1262
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -l json -d 'Emit the result as JSON instead of prose'
1263
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from test' -s h -l help -d 'display help for command'
1222
1264
  # ---------- dataset view ----------
1223
1265
  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).'
1224
1266
  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.'
@@ -1242,7 +1284,9 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1242
1284
  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
1243
1285
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -s n -l name -d 'View name' -x
1244
1286
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -s q -l query -d 'SQL query the view executes' -x
1287
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -s s -l source -d 'Bind the view to one datasource and run the query natively against it, instead of through the federated SQLite layer. Same reference `dataset query -s` takes' -x
1245
1288
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -l view-id -d 'Override the generated view id (local only; cloud assigns its own)' -x
1289
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -l json -d 'Emit the result as JSON instead of prose'
1246
1290
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
1247
1291
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -s h -l help -d 'display help for command'
1248
1292
  # ---------- dataset view delete ----------
@@ -1255,6 +1299,15 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1255
1299
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s q -l query -d 'New SQL query' -x
1256
1300
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
1257
1301
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
1302
+ # ---------- dataset jdbc ----------
1303
+ complete -c postman -n '__postman_using_subcommand jdbc inspect' -a inspect -d 'Detect Java, list driver classes, suggest a URL template and read driver properties.'
1304
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc' -s h -l help -d 'display help for command'
1305
+ # ---------- dataset jdbc inspect ----------
1306
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -l driver-class -d 'Introspect this class instead of auto-selecting' -x
1307
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -l url-template -d 'Use this URL template instead of the one inferred from the JAR filename' -x
1308
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -l java-path -d 'Java runtime to use. Machine-local only — never written to a dataset. Also read from POSTMAN_JDBC_JAVA_PATH.' -r
1309
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -l json -d 'Emit the discovery result as JSON'
1310
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -s h -l help -d 'display help for command'
1258
1311
 
1259
1312
  # ---------- dependency ----------
1260
1313
  complete -c postman -n '__postman_using_subcommand dependency add list install update' -a add -d 'Add a Postman collection, environment, or mock as a workspace dependency.'
@@ -1,6 +1,6 @@
1
1
  #compdef postman
2
2
  compdef _postman postman
3
- # Zsh completion for Postman CLI (postman v1.59.0)
3
+ # Zsh completion for Postman CLI (postman v1.60.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
@@ -67,7 +67,7 @@ _postman_commands() {
67
67
  'environment:Work with local Postman environments from the command line. Also read cloud environments by ID.'
68
68
  'globals:Work with local Postman globals from the command line.'
69
69
  'api:Publish and test your APIs directly from the command line'
70
- 'runner:Where your monitors execute\: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team'
70
+ 'runner:Where your monitors execute\: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team.'
71
71
  'spec:Lint and validate Specifications from the command line'
72
72
  'monitor:Run and manage Postman monitors.'
73
73
  'workspace:Manage workspace resources.'
@@ -102,9 +102,7 @@ _postman_login() {
102
102
 
103
103
  _postman_signup() {
104
104
  _arguments \
105
- '--browser[Always open the sign-up URL in a browser here, rather than printing it.]' \
106
- '--wait[Wait for the sign-up to complete even if no local browser is detected.]' \
107
- '--no-wait[Print the sign-up URL and exit without waiting. Leaves this CLI a guest.]' \
105
+ '--guest[Start working as an anonymous guest instead of signing up — no account or browser needed, so it works anywhere. Your work is saved to a temporary workspace you can keep later by running `postman signup`.]' \
108
106
  '--json[Print the sign-up details as machine-readable JSON.]' \
109
107
  '(-h --help)'{-h,--help}'[display help for command]'
110
108
  }
@@ -136,6 +134,7 @@ _postman_whoami() {
136
134
 
137
135
  _postman_update() {
138
136
  _arguments \
137
+ '--check[Check whether a Postman CLI update is available.]' \
139
138
  '(-h --help)'{-h,--help}'[display help for command]'
140
139
  }
141
140
 
@@ -553,9 +552,9 @@ _postman_runner() {
553
552
  _postman_runner_commands() {
554
553
  local -a sub
555
554
  sub=(
556
- 'start:Start a runner'
557
- 'list:List the team'\''s registered self-hosted runners'
558
- 'regions:List the region and private-runner values valid for monitor create/update --runner, including a static IP where configured'
555
+ 'start:Start a self-hosted runner in your own network.'
556
+ 'list:List the team'\''s registered self-hosted runners.'
557
+ 'regions:List the region and private-runner values valid for monitor create/update --runner, with the static IP Postman runs each one from, where your team has access to it.'
559
558
  )
560
559
  _describe -t commands 'runner command' sub
561
560
  }
@@ -564,15 +563,16 @@ _postman_runner_start() {
564
563
  _arguments \
565
564
  '--id[The ID of the runner to execute]:id' \
566
565
  '--key[The secret key for the runner]:key:_files -g "*.(pem|crt|key)"' \
567
- '--region[Specify the region for the runner. Use "eu" for EU region.]:region' \
568
- '--proxy[External proxy URL (e.g., http\://proxy.com or http\://proxy.com\:8080)]:url' \
566
+ '--region[Region this runner reports to -- use "eu" for the EU region]:region' \
567
+ '--proxy[External proxy URL, for example http\://proxy.com or http\://proxy.com\:8080]:url' \
569
568
  '--egress-proxy[Enable built-in egress proxy]' \
570
569
  '--egress-proxy-authz-url[Custom egress proxy authorization service base URL]:url' \
571
570
  '--ssl-extra-ca-certs[Additional trusted CA certificates (PEM file, can contain multiple certs)]:path:_files -g "*.(pem|crt|key)"' \
571
+ '--dataset-jdbc-driver-dir[Folder on this machine holding the JDBC driver .jar files you put there. Required to run a dataset that uses a JDBC source. Drivers are loaded only from this folder and matched by file name; driver paths saved in the dataset are ignored]:path:_files -/' \
572
572
  '--metrics[Enable the metrics server for health checks]' \
573
573
  '--metrics-port[Port for the metrics server (default\: "9090")]:port' \
574
- '--report-events[Accepted for compatibility; analytics are sent by default]' \
575
- '--no-report-events[Do not send analytics to Postman]' \
574
+ '--report-events[Accepted for compatibility; run events are reported by default]' \
575
+ '--no-report-events[Do not report run events to Postman]' \
576
576
  '(-h --help)'{-h,--help}'[display help for command]'
577
577
  }
578
578
 
@@ -808,7 +808,7 @@ _postman_monitor_commands() {
808
808
 
809
809
  _postman_monitor_run() {
810
810
  _arguments \
811
- '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
811
+ '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
812
812
  '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Specify whether or not to override the default exit code for the current run]' \
813
813
  '(-t --timeout)'{-t,--timeout}'[Maximum wait time for run completion in milliseconds (default\: 15 minutes) (default\: 900000)]:ms' \
814
814
  '--async[Submit the run and return immediately with its job id and Postman URL, without waiting for completion]' \
@@ -821,14 +821,14 @@ _postman_monitor_create() {
821
821
  _arguments \
822
822
  '(-c --collection)'{-c,--collection}'[Collection to monitor -- accepts the id shown in the Postman app, prefixed or bare]:id' \
823
823
  '--name[Monitor name (defaults to the linked collection'\''s own name)]:name' \
824
- '--environment[Environment to run the monitored collection with]:id' \
824
+ '(-e --environment)'{-e,--environment}'[Environment to run the monitored collection with]:id' \
825
825
  '(-w --workspace)'{-w,--workspace}'[Workspace to create the monitor in (defaults to the workspace named in the local .postman/resources.yaml manifest; required if neither is available)]:id' \
826
826
  '--schedule[Cron expression for the monitor'\''s schedule]:cron' \
827
- '--timezone[Time zone for --schedule, e.g. America/New_York (defaults to the host machine'\''s own zone)]:tz' \
827
+ '--timezone[Time zone for --schedule, for example America/New_York (defaults to the host machine'\''s own zone)]:tz' \
828
828
  '--runner[A Postman region name (see `postman runner regions`) or the id of a self-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable) (default\: \[\])]:value' \
829
829
  '--notify-email[Email to notify on a run failure or error (repeatable) (default\: \[\])]:email' \
830
- '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
831
- '--retry[Retries on a failed run (service caps this at 2)]:n' \
830
+ '--notification-limit[Consecutive failure notifications to send before muting them]:n' \
831
+ '--retry[Times to retry a failed run]:n' \
832
832
  '--timeout[Request timeout in milliseconds]:ms' \
833
833
  '--delay[Delay between requests in milliseconds]:ms' \
834
834
  '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
@@ -838,7 +838,7 @@ _postman_monitor_create() {
838
838
  '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
839
839
  '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
840
840
  '--iteration-count[Number of iterations to run]:n' \
841
- '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
841
+ '--iteration-strategy[How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
842
842
  '--no-run-now[Do not trigger an immediate run after creating the monitor]' \
843
843
  '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
844
844
  '--json[Output as JSON instead of a table]' \
@@ -849,12 +849,14 @@ _postman_monitor_update() {
849
849
  _arguments \
850
850
  '--name[New monitor name]:name' \
851
851
  '--schedule[New cron expression for the monitor'\''s schedule]:cron' \
852
- '--timezone[Time zone for --schedule, e.g. America/New_York (defaults to the host machine'\''s own zone)]:tz' \
852
+ '--timezone[Time zone for --schedule, for example America/New_York (defaults to the host machine'\''s own zone)]:tz' \
853
853
  '--runner[A Postman region name (see `postman runner regions`) or the id of a self-hosted runner created in Postman (list existing ones with `postman runner list`) to run from (repeatable; replaces the current set) (default\: \[\])]:value' \
854
854
  '--notify-email[Email to notify on a run failure or error (repeatable; replaces the current list) (default\: \[\])]:email' \
855
855
  '--clear-notifications[Remove every notification recipient]' \
856
- '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
857
- '--retry[Retries on a failed run (service caps this at 2)]:n' \
856
+ '(-e --environment)'{-e,--environment}'[Environment to run the monitored collection with (replaces the current one)]:id' \
857
+ '--clear-environment[Run the monitored collection with no environment]' \
858
+ '--notification-limit[Consecutive failure notifications to send before muting them]:n' \
859
+ '--retry[Times to retry a failed run]:n' \
858
860
  '--timeout[Request timeout in milliseconds]:ms' \
859
861
  '--delay[Delay between requests in milliseconds]:ms' \
860
862
  '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
@@ -864,7 +866,7 @@ _postman_monitor_update() {
864
866
  '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
865
867
  '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
866
868
  '--iteration-count[Number of iterations to run]:n' \
867
- '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
869
+ '--iteration-strategy[How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
868
870
  '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
869
871
  '--json[Output as JSON instead of a table]' \
870
872
  '(-h --help)'{-h,--help}'[display help for command]' \
@@ -908,9 +910,9 @@ _postman_monitor_jobs_commands() {
908
910
 
909
911
  _postman_monitor_jobs_list() {
910
912
  _arguments \
911
- '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
912
- '--result[Filter by outcome, e.g. success, failure, error, abort (server-validated, not a fixed list)]:value' \
913
- '--trigger[Filter by trigger, e.g. api, schedule, webhook, postman-cli (server-validated, not a fixed list)]:value' \
913
+ '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
914
+ '--result[Filter by outcome, for example success, failure, error or abort]:value' \
915
+ '--trigger[Filter by trigger, for example api, schedule, webhook or postman-cli]:value' \
914
916
  '--since[Only jobs that finished at or after this ISO 8601 date-time]:dateTime' \
915
917
  '--limit[Maximum number of jobs to return]:n' \
916
918
  '--cursor[Opaque pagination cursor]:token' \
@@ -921,7 +923,7 @@ _postman_monitor_jobs_list() {
921
923
 
922
924
  _postman_monitor_jobs_get() {
923
925
  _arguments \
924
- '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
926
+ '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
925
927
  '--json[Output as JSON instead of a table]' \
926
928
  '(-h --help)'{-h,--help}'[display help for command]' \
927
929
  '*:jobId:'
@@ -953,8 +955,8 @@ _postman_monitor_runs_commands() {
953
955
 
954
956
  _postman_monitor_runs_get() {
955
957
  _arguments \
956
- '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
957
- '--attempt[Which attempt of the run to show, counting from 0 (default\: the latest)]:n' \
958
+ '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
959
+ '--attempt[Which attempt of the run to show, where 0 is the first (default\: the most recent)]:n' \
958
960
  '--failed-only[Show only failed assertions]' \
959
961
  '--json[Output as JSON instead of a table]' \
960
962
  '(-h --help)'{-h,--help}'[display help for command]' \
@@ -966,15 +968,14 @@ _postman_monitor_list() {
966
968
  '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
967
969
  '(-w --workspace)'{-w,--workspace}'[Filter to monitors in this workspace]:id' \
968
970
  '(-c --collection)'{-c,--collection}'[Filter to monitors on this collection]:id' \
969
- '--environment[Filter to monitors on this environment]:id' \
970
- '--runner[Filter to a Self-Hosted Runner ID (not a Postman Region). Cannot be combined with --workspace, --collection, --environment, --owner, --team or --active.]:id' \
971
+ '(-e --environment)'{-e,--environment}'[Filter to monitors on this environment]:id' \
972
+ '--runner[Filter to a self-hosted runner id, not a Postman region. Cannot be combined with --workspace, --collection, --environment, --owner, --team or --active]:id' \
971
973
  '--owner[Filter to monitors created by this user id (shown in the Owner column)]:id' \
972
974
  '--team[Filter to monitors owned by your own team]' \
973
975
  '--active[Filter by active state]:true|false' \
974
- '--limit[Max monitors to return. The service caps page size and rejects a value above it with its own error.]:n' \
975
- '--offset[Not supported\: the service accepts this parameter and silently ignores it. Refused locally. Use --cursor instead.]:n' \
976
- '--cursor[Pagination cursor from a previous page'\''s response.]:token' \
977
- '--columns[Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available\: State, Notifications, Environment, Runners.]:names' \
976
+ '--limit[Maximum number of monitors to return (Postman caps the page size and rejects a larger value)]:n' \
977
+ '--cursor[Pagination cursor from a previous page'\''s response]:token' \
978
+ '--columns[Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available\: State, Notifications, Environment, Runners]:names' \
978
979
  '--no-headers[Omit the header row]' \
979
980
  '(-f --filter)'{-f,--filter}'[Show only monitors whose name contains this text (applies to the returned page, case-insensitive)]:text' \
980
981
  '--sort[Sort the returned page by "name" or "active"]:field' \
@@ -993,10 +994,10 @@ _postman_monitor_get() {
993
994
  _postman_monitor_metrics() {
994
995
  _arguments \
995
996
  '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
996
- '--since[Only executions at or after this ISO 8601 date-time. Defaults to 7 days ago.]:dateTime' \
997
- '--until[Only executions at or before this ISO 8601 date-time. Defaults to now.]:dateTime' \
997
+ '--since[Only executions at or after this ISO 8601 date-time (defaults to 7 days ago)]:dateTime' \
998
+ '--until[Only executions at or before this ISO 8601 date-time (defaults to now)]:dateTime' \
998
999
  '(-f --filter)'{-f,--filter}'[Show only requests whose name contains this text (case-insensitive)]:text' \
999
- '--limit[Cap the number of rows shown\: executions (newest first) under --json, or table rows (worst-behaving request first) otherwise. Not honoured by the service -- there is no server-side pagination on this route.]:n' \
1000
+ '--limit[Maximum number of rows to show\: executions, newest first, under --json, or requests, worst-behaving first, in the table. Applied to the results after they are fetched, so it does not make the command faster]:n' \
1000
1001
  '--json[Output as JSON instead of a table]' \
1001
1002
  '(-h --help)'{-h,--help}'[display help for command]' \
1002
1003
  '*:monitorId:'
@@ -1032,6 +1033,7 @@ _postman_workspace() {
1032
1033
  prepare) _postman_workspace_prepare ;;
1033
1034
  push) _postman_workspace_push ;;
1034
1035
  lint) _postman_workspace_lint ;;
1036
+ get) _postman_workspace_get ;;
1035
1037
  create) _postman_workspace_create ;;
1036
1038
  pull) _postman_workspace_pull ;;
1037
1039
  connect-git) _postman_workspace_connect_git ;;
@@ -1048,6 +1050,7 @@ _postman_workspace_commands() {
1048
1050
  'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
1049
1051
  'push:Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
1050
1052
  'lint:Lint the current local Postman workspace\: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
1053
+ 'get:Read a workspace'\''s metadata, and optionally the ids of what it holds.'
1051
1054
  'create:Create a Postman workspace and bind it to this git repository.'
1052
1055
  'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
1053
1056
  'connect-git:Connect a Postman workspace to a local git repository.'
@@ -1093,6 +1096,15 @@ _postman_workspace_lint() {
1093
1096
  '(-h --help)'{-h,--help}'[display help for command]'
1094
1097
  }
1095
1098
 
1099
+ _postman_workspace_get() {
1100
+ _arguments \
1101
+ '--elements[Also report the resources the workspace holds.]' \
1102
+ '--json[Print the workspace as machine-readable JSON.]' \
1103
+ '--timeout[Milliseconds to wait for the API (default 30000).]:ms' \
1104
+ '(-h --help)'{-h,--help}'[display help for command]' \
1105
+ '*:id:'
1106
+ }
1107
+
1096
1108
  _postman_workspace_create() {
1097
1109
  _arguments \
1098
1110
  '--visibility[Required. Workspace visibility, e.g. personal or team]:status' \
@@ -1143,7 +1155,7 @@ _postman_performance() {
1143
1155
  args)
1144
1156
  case $words[1] in
1145
1157
  run) _postman_performance_run ;;
1146
- runs) _postman_performance_runs ;;
1158
+ list) _postman_performance_list ;;
1147
1159
  esac
1148
1160
  ;;
1149
1161
  esac
@@ -1153,7 +1165,7 @@ _postman_performance_commands() {
1153
1165
  local -a sub
1154
1166
  sub=(
1155
1167
  'run:Run a performance test on a collection'
1156
- 'runs:List past performance runs for a collection, newest first.'
1168
+ 'list:List past performance runs for a collection, newest first.'
1157
1169
  )
1158
1170
  _describe -t commands 'performance command' sub
1159
1171
  }
@@ -1179,7 +1191,7 @@ _postman_performance_run() {
1179
1191
  '*:collectionId:_files -g "*.json"'
1180
1192
  }
1181
1193
 
1182
- _postman_performance_runs() {
1194
+ _postman_performance_list() {
1183
1195
  _arguments \
1184
1196
  '(-c --collection-id)'{-c,--collection-id}'[Collection ID whose performance runs to list]:id' \
1185
1197
  '--cursor[Pagination cursor from a previous page'\''s response]:token' \
@@ -2316,6 +2328,7 @@ _postman_dataset() {
2316
2328
  delete) _postman_dataset_delete ;;
2317
2329
  source) _postman_dataset_source ;;
2318
2330
  view) _postman_dataset_view ;;
2331
+ jdbc) _postman_dataset_jdbc ;;
2319
2332
  esac
2320
2333
  ;;
2321
2334
  esac
@@ -2331,6 +2344,7 @@ _postman_dataset_commands() {
2331
2344
  'delete:Permanently remove a dataset\: a local .dataset.yaml or a cloud dataset id.'
2332
2345
  'source:Inspect and manage a dataset'\''s datasources.'
2333
2346
  'view:Inspect and manage saved views on a dataset.'
2347
+ 'jdbc:Inspect JDBC drivers before attaching one to a dataset.'
2334
2348
  )
2335
2349
  _describe -t commands 'dataset command' sub
2336
2350
  }
@@ -2400,6 +2414,7 @@ _postman_dataset_source() {
2400
2414
  add) _postman_dataset_source_add ;;
2401
2415
  remove) _postman_dataset_source_remove ;;
2402
2416
  update) _postman_dataset_source_update ;;
2417
+ test) _postman_dataset_source_test ;;
2403
2418
  esac
2404
2419
  ;;
2405
2420
  esac
@@ -2412,6 +2427,7 @@ _postman_dataset_source_commands() {
2412
2427
  'add:Add a datasource to a dataset.'
2413
2428
  'remove:Remove a datasource from a dataset (local YAML path or cloud id).'
2414
2429
  'update:Update fields on an existing datasource. Only the flags you provide are changed.'
2430
+ 'test:Open and close a real connection using a source'\''s stored configuration.'
2415
2431
  )
2416
2432
  _describe -t commands 'source command' sub
2417
2433
  }
@@ -2430,15 +2446,28 @@ _postman_dataset_source_add() {
2430
2446
  '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
2431
2447
  '--source-id[Override the generated source id (local dataset only)]:uuid' \
2432
2448
  '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
2433
- '--type[Source kind; local is inferred when --file is provided]:local|mysql|postgresql|sqlserver' \
2449
+ '--type[Source kind; local is inferred from --file, jdbc from --driver-jar]:local|mysql|postgresql|sqlserver|jdbc' \
2434
2450
  '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
2435
2451
  '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
2436
2452
  '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
2437
2453
  '--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.]' \
2454
+ '--driver-jar[JDBC driver JAR(s). Repeatable, or pass several after one flag]:path...:_files -g "*.json"' \
2455
+ '--driver-class[Driver class. Auto-resolved when the JAR contains exactly one]:fqcn' \
2456
+ '--driver-name[Label for this driver type (defaults to the JAR filename)]:label' \
2457
+ '--url-template[JDBC URL with {{placeholders}}, e.g. jdbc\:postgresql\://{{host}}\:{{port}}/{{database}}]:template' \
2458
+ '--var[Value for a {{placeholder}}. Repeatable. Use vault\:<vaultId>/<secretId> for a secret. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:name=value...' \
2459
+ '--prop[Driver connection property. Repeatable. Same vault\: syntax as --var]:name=value...' \
2460
+ '--vars-file[JSON object of --var values; "-" reads stdin. Supports {"$vaultId"\:..,"$secretId"\:..} objects, and keeps secrets out of argv entirely]:path:_files -g "*.json"' \
2461
+ '--from-source[Reuse another source'\''s driver JAR, class and URL template]:name' \
2462
+ '--java-path[Java runtime to use. Machine-local only - never written to the dataset. Also read from POSTMAN_JDBC_JAVA_PATH]:path:_files -g "*.json"' \
2463
+ '--no-test[Skip the pre-write connection test. Note that resolving the driver class still starts a JVM — on a machine with no Java, pass --driver-class (or --from-source) too]' \
2464
+ '--ssh-target-host-variable[Template variable holding the tunnelled host (inferred when omitted)]:name' \
2465
+ '--ssh-target-port-variable[Template variable holding the tunnelled port (inferred when omitted)]:name' \
2466
+ '--json[Emit the result as JSON instead of prose]' \
2438
2467
  '--host[DB host (mysql/postgresql/sqlserver)]:host' \
2439
2468
  '--port[DB port (defaults to 1433 for sqlserver)]:port' \
2440
- '--user[DB user (warning\: stored as plaintext in the YAML).]:user' \
2441
- '--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' \
2469
+ '--user[DB user. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:user' \
2470
+ '--password[DB password. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:password' \
2442
2471
  '--database[DB database name]:db' \
2443
2472
  '--table[DB table name (required for sqlserver)]:table' \
2444
2473
  '--ssh-host[SSH bastion host]:host' \
@@ -2476,10 +2505,22 @@ _postman_dataset_source_update() {
2476
2505
  '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
2477
2506
  '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
2478
2507
  '--force[With --file, overwrite the copied destination (local dataset only)]' \
2508
+ '--driver-jar[Replace the JDBC driver JAR(s)]:path...:_files -g "*.json"' \
2509
+ '--driver-class[Replace the JDBC driver class]:fqcn' \
2510
+ '--driver-name[Rename the JDBC driver type label]:label' \
2511
+ '--url-template[Replace the JDBC URL template]:template' \
2512
+ '--var[Set a JDBC template variable. Merges onto the existing values. Use vault\:<vaultId>/<secretId> for a secret. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:name=value...' \
2513
+ '--prop[Set a JDBC connection property. Merges, same vault\: syntax]:name=value...' \
2514
+ '--unset-var[Remove a JDBC template variable. Merging alone can never remove a key]:name...' \
2515
+ '--unset-prop[Remove a JDBC connection property]:name...' \
2516
+ '--vars-file[JSON object of --var values; "-" reads stdin]:path:_files -g "*.json"' \
2517
+ '--ssh-target-host-variable[Template variable holding the tunnelled host (JDBC)]:name' \
2518
+ '--ssh-target-port-variable[Template variable holding the tunnelled port (JDBC)]:name' \
2519
+ '--java-path[Java runtime for JDBC operations. Machine-local only]:path:_files -g "*.json"' \
2479
2520
  '--host[Update DB host (mysql/postgresql/sqlserver)]:host' \
2480
2521
  '--port[Update DB port]:port' \
2481
- '--user[Update DB user (warning\: stored as plaintext in the YAML).]:user' \
2482
- '--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' \
2522
+ '--user[Update DB user. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:user' \
2523
+ '--password[Update DB password. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:password' \
2483
2524
  '--database[Update DB database name]:db' \
2484
2525
  '--table[Update DB table name]:table' \
2485
2526
  '--ssh-host[Update SSH bastion host]:host' \
@@ -2497,10 +2538,21 @@ _postman_dataset_source_update() {
2497
2538
  '--host-name-in-certificate[Update SQL Server certificate hostname override]:hostname' \
2498
2539
  '--tls-min-version[Update SQL Server minimum TLS version]:1.2|1.3' \
2499
2540
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
2541
+ '--json[Emit the result as JSON instead of prose]' \
2500
2542
  '(-h --help)'{-h,--help}'[display help for command]' \
2501
2543
  '*:sourceNameOrId:'
2502
2544
  }
2503
2545
 
2546
+ _postman_dataset_source_test() {
2547
+ _arguments \
2548
+ '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
2549
+ '(-n --name)'{-n,--name}'[Source to test]:name' \
2550
+ '--java-path[Java runtime to use for a JDBC source. Machine-local only; also read from POSTMAN_JDBC_JAVA_PATH]:path:_files -g "*.json"' \
2551
+ '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
2552
+ '--json[Emit the result as JSON instead of prose]' \
2553
+ '(-h --help)'{-h,--help}'[display help for command]'
2554
+ }
2555
+
2504
2556
  _postman_dataset_view() {
2505
2557
  local context state state_descr line
2506
2558
  typeset -A opt_args
@@ -2557,7 +2609,9 @@ _postman_dataset_view_create() {
2557
2609
  '(-d --dataset)'{-d,--dataset}'[Dataset to add the view to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
2558
2610
  '(-n --name)'{-n,--name}'[View name]:name' \
2559
2611
  '(-q --query)'{-q,--query}'[SQL query the view executes]:sql' \
2612
+ '(-s --source)'{-s,--source}'[Bind the view to one datasource and run the query natively against it, instead of through the federated SQLite layer. Same reference `dataset query -s` takes]:nameOrIdOrSlug' \
2560
2613
  '--view-id[Override the generated view id (local only; cloud assigns its own)]:uuid' \
2614
+ '--json[Emit the result as JSON instead of prose]' \
2561
2615
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
2562
2616
  '(-h --help)'{-h,--help}'[display help for command]'
2563
2617
  }
@@ -2580,6 +2634,40 @@ _postman_dataset_view_update() {
2580
2634
  '*:viewNameOrId:'
2581
2635
  }
2582
2636
 
2637
+ _postman_dataset_jdbc() {
2638
+ local context state state_descr line
2639
+ typeset -A opt_args
2640
+ _arguments -C \
2641
+ '(-h --help)'{-h,--help}'[display help for command]' \
2642
+ '1: :_postman_dataset_jdbc_commands' \
2643
+ '*::arg:->args'
2644
+ case $state in
2645
+ args)
2646
+ case $words[1] in
2647
+ inspect) _postman_dataset_jdbc_inspect ;;
2648
+ esac
2649
+ ;;
2650
+ esac
2651
+ }
2652
+
2653
+ _postman_dataset_jdbc_commands() {
2654
+ local -a sub
2655
+ sub=(
2656
+ 'inspect:Detect Java, list driver classes, suggest a URL template and read driver properties.'
2657
+ )
2658
+ _describe -t commands 'jdbc command' sub
2659
+ }
2660
+
2661
+ _postman_dataset_jdbc_inspect() {
2662
+ _arguments \
2663
+ '--driver-class[Introspect this class instead of auto-selecting]:fqcn' \
2664
+ '--url-template[Use this URL template instead of the one inferred from the JAR filename]:template' \
2665
+ '--java-path[Java runtime to use. Machine-local only — never written to a dataset. Also read from POSTMAN_JDBC_JAVA_PATH.]:path:_files -g "*.json"' \
2666
+ '--json[Emit the discovery result as JSON]' \
2667
+ '(-h --help)'{-h,--help}'[display help for command]' \
2668
+ '*:jar...:'
2669
+ }
2670
+
2583
2671
  _postman_dependency() {
2584
2672
  local context state state_descr line
2585
2673
  typeset -A opt_args
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "postman-cli-completion",
3
- "version": "1.59.0",
3
+ "version": "1.60.0",
4
4
  "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
5
5
  "type": "module",
6
6
  "bin": {