postman-cli-completion 1.44.0 → 1.45.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.44.0)
+# Bash completion for Postman CLI (postman v1.45.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -22,7 +22,7 @@ _postman() {
   cur="${COMP_WORDS[COMP_CWORD]}"
   prev="${COMP_WORDS[COMP_CWORD-1]}"
 
-  local top_commands="login logout collection api runner spec monitor workspace performance flows fl request sdk mock application app simulate context search webhook dataset"
+  local top_commands="login logout collection api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset"
   local global_flags="-v --version --silent --color -h --help -h --help"
 
   local i cmd="" subcmd=""
@@ -53,7 +53,7 @@ _postman() {
     runner) _postman_runner ;;
     spec) _postman_spec ;;
     monitor) _postman_monitor ;;
-    workspace) _postman_workspace ;;
+    workspace|ws) _postman_workspace ;;
     performance) _postman_performance ;;
     flows|fl) _postman_flows ;;
     request) _postman_request ;;
@@ -332,16 +332,26 @@ _postman_workspace() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "prepare push" -- "$cur") )
+      COMPREPLY=( $(compgen -W "list prepare push" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
+    list) _postman_workspace_list ;;
     prepare) _postman_workspace_prepare ;;
     push) _postman_workspace_push ;;
   esac
 }
 
+_postman_workspace_list() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-f --filter -t --type --verbose --debug --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_workspace_prepare() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "--verbose -h --help" -- "$cur") )
@@ -1146,46 +1156,64 @@ _postman_dataset() {
 
 _postman_dataset_list() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-w --workspace --api-key --json -h --help" -- "$cur") )
     return 0
   fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
   _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_dataset_get() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--api-key --no-populate --json -h --help" -- "$cur") )
     return 0
   fi
-  _postman_filematch '!*.@(json)' "$cur"
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_query() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-q --query -p --param --json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-q --query -p --param --api-key --json -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
-  _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_dataset_create() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-n --name -d --description --id --force -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-n --name -d --description --dataset-id --force -w --workspace --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
   _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_dataset_delete() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-y --yes --keep-resources -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-y --yes --keep-resources --api-key -h --help" -- "$cur") )
     return 0
   fi
-  _postman_filematch '!*.@(json)' "$cur"
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_source() {
@@ -1207,41 +1235,55 @@ _postman_dataset_source() {
 
 _postman_dataset_source_list() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset --api-key --json -h --help" -- "$cur") )
     return 0
   fi
-  _postman_filematch '!*.@(json)' "$cur"
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_source_add() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-n --name --id --format --type --file --ref-only --force --url --host --port --user --password --database --table --slug -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset -n --name --source-id --format --type --file --ref-only --force --upload --url --host --port --user --password --database --table --slug --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
     --file)
       _postman_filematch '!*.@(json)' "$cur"
       return 0 ;;
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
-  _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_dataset_source_remove() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset --api-key -h --help" -- "$cur") )
     return 0
   fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_source_update() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-n --name --format --file --ref-only --force --url --host --port --user --password --database --table --slug -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset -n --name --format --file --ref-only --force --url --host --port --user --password --database --table --slug --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
     --file)
       _postman_filematch '!*.@(json)' "$cur"
       return 0 ;;
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
 }
 
@@ -1265,44 +1307,61 @@ _postman_dataset_view() {
 
 _postman_dataset_view_list() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset --api-key --json -h --help" -- "$cur") )
     return 0
   fi
-  _postman_filematch '!*.@(json)' "$cur"
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_view_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-p --param --json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset -p --param --api-key --json -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
 }
 
 _postman_dataset_view_create() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-n --name -q --query --id -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset -n --name -q --query --view-id --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
-  _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_dataset_view_delete() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset --api-key -h --help" -- "$cur") )
     return 0
   fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
 }
 
 _postman_dataset_view_update() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-n --name -q --query -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-d --dataset -n --name -q --query --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
 }
 

package/completions/fish/postman.fish

@@ -1,10 +1,10 @@
-# Fish completion for Postman CLI (postman v1.44.0)
+# Fish completion for Postman CLI (postman v1.45.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
 
 function __postman_no_subcommand
-    not __fish_seen_subcommand_from login logout collection api runner spec monitor workspace performance flows fl request sdk mock application app simulate context search webhook dataset
+    not __fish_seen_subcommand_from login logout collection api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset
 end
 
 function __postman_using_subcommand
@@ -29,6 +29,7 @@ complete -c postman -n __postman_no_subcommand -a runner -d 'Run runners on your
 complete -c postman -n __postman_no_subcommand -a spec -d 'Lint and validate Specifications from the command line'
 complete -c postman -n __postman_no_subcommand -a monitor -d 'Invoke a monitor run and display results'
 complete -c postman -n __postman_no_subcommand -a workspace -d 'Manage workspace resources.'
+complete -c postman -n __postman_no_subcommand -a ws -d 'Alias for workspace'
 complete -c postman -n __postman_no_subcommand -a performance -d 'Manage performance tests on your collections.'
 complete -c postman -n __postman_no_subcommand -a flows -d 'Manage and interact with flows.'
 complete -c postman -n __postman_no_subcommand -a fl -d 'Alias for flows'
@@ -82,9 +83,9 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l reporter-json-structure -d '[Optional] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s n -l iteration-count -d 'Define the number of iterations to run' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s d -l iteration-data -d 'Specify a data file to use for iterations (either JSON or CSV)' -r
-complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-dataset -d '[BETA] Path to a .dataset.yaml whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.' -r
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-dataset -d '[BETA] Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-view -d '[BETA] Name or id of the view to execute (within --iteration-data-dataset). The view\'s result set drives one iteration per row.' -x
-complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l dataset -d '[BETA] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection\'s parent repo is disabled. (default: [])' -r
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l dataset -d '[BETA] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection\'s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default: [])' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s i -d 'Specify the request/folder id, name, or path to run from the collection. Use a path (e.g. "FolderName/RequestName") to disambiguate items with the same name. Can be specified multiple times to run multiple items (default: [])' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l global-var -d 'Allows the specification of global variables via the command line, in a key=value format' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l env-var -d 'Allows the specification of environment variables via the command line, in a key=value format (default: [])' -x
@@ -186,9 +187,17 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
 
 # ---------- workspace ----------
-complete -c postman -n '__postman_using_subcommand workspace prepare push' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
-complete -c postman -n '__postman_using_subcommand workspace prepare push' -a push -d 'Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push' -a list -d 'List all available Postman Workspaces'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push' -a push -d 'Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
 complete -c postman -n '__fish_seen_subcommand_from workspace' -s h -l help -d 'display help for command'
+# ---------- workspace list ----------
+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
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -s t -l type -d 'Filter workspaces by visibility type: team, public, private, personal.' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -l debug -d 'Debug output'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 # ---------- workspace prepare ----------
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from prepare' -l verbose -d 'Show detailed logging'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from prepare' -s h -l help -d 'display help for command'
@@ -344,7 +353,7 @@ complete -c postman -n '__fish_seen_subcommand_from request' -l auth-apikey-in -
 
 # ---------- sdk ----------
 complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a init -d 'Create or update .postman/config.json with an SDK configuration stub.'
-complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a generate -d 'Generate a new SDK from a Postman collection or specification.'
+complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a generate -d 'Generate a new SDK from a Postman collection or specification (OpenAPI or AsyncAPI).'
 complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a build -d 'Alias for generate'
 complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a track -d 'Enable change tracking for a generated SDK. Adds file hashes to .manifest.json so that the next `sdk generate` can detect your edits and preserve them via 3-way merge.'
 complete -c postman -n '__postman_using_subcommand sdk init generate build track list ls fetch get connect connections' -a list -d 'List SDK builds for a collection, extensible collection, or specification.'
@@ -602,71 +611,82 @@ complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from webhook; and __fish_seen_subcommand_from forward' -s h -l help -d 'display help for command'
 
 # ---------- dataset ----------
-complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a list -d '[BETA] List dataset YAMLs under the given directory, or print summary for a single YAML file.'
-complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a get -d '[BETA] Print a dataset\'s metadata and structure summary.'
-complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a query -d '[BETA] Run an ad-hoc SQL query against a dataset.'
-complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a create -d '[BETA] Scaffold a new empty .dataset.yaml file at <path>.'
-complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a delete -d '[BETA] Permanently remove a dataset\'s .dataset.yaml file and its .resources/ directory.'
+complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a list -d '[BETA] List local dataset YAMLs under a path, or (no path) a workspace\'s cloud datasets.'
+complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a get -d '[BETA] Print a dataset\'s metadata and structure summary (local YAML path or cloud id).'
+complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a query -d '[BETA] Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
+complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a create -d '[BETA] Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
+complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a delete -d '[BETA] Permanently remove a dataset: a local .dataset.yaml (+ .resources/) or a cloud dataset id.'
 complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a source -d '[BETA] Inspect and manage a dataset\'s datasources.'
 complete -c postman -n '__postman_using_subcommand dataset list get query create delete source view' -a view -d '[BETA] Inspect and manage saved views on a dataset.'
 complete -c postman -n '__fish_seen_subcommand_from dataset' -s h -l help -d 'display help for command'
 # ---------- dataset list ----------
+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
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from list' -l json -d 'Output as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset get ----------
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l json -d 'Output the full parsed YAML as JSON'
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l no-populate -d 'Skip fetching datasources/views for a cloud dataset'
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l json -d 'Output the full dataset as JSON'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset query ----------
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s q -l query -d 'SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s p -l param -d 'Positional parameter values for $1, $2, ... bindings; repeatable' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l json -d 'Output rows as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset create ----------
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -s n -l name -d 'Human-readable name for the dataset' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -s d -l description -d 'Optional description' -x
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -l id -d 'Override the generated dataset id (defaults to a random v4 UUID)' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -l dataset-id -d 'Override the generated dataset id (local only; defaults to a random v4 UUID)' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -l force -d 'Overwrite an existing file at <path>'
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -s w -l workspace -d 'Postman workspace ID (create a cloud dataset)' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from create' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset delete ----------
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -l keep-resources -d 'Delete only the YAML file; leave the .resources/ directory intact'
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -l keep-resources -d 'Delete only the YAML file; leave the .resources/ directory intact (local only)'
+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
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from delete' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset source ----------
-complete -c postman -n '__postman_using_subcommand source list add remove update' -a list -d '[BETA] List the datasources defined on a dataset.'
+complete -c postman -n '__postman_using_subcommand source list add remove update' -a list -d '[BETA] List the datasources defined on a dataset (local YAML path or cloud id).'
 complete -c postman -n '__postman_using_subcommand source list add remove update' -a add -d '[BETA] Add a datasource to a dataset.'
-complete -c postman -n '__postman_using_subcommand source list add remove update' -a remove -d '[BETA] Remove a datasource from a dataset.'
+complete -c postman -n '__postman_using_subcommand source list add remove update' -a remove -d '[BETA] Remove a datasource from a dataset (local YAML path or cloud id).'
 complete -c postman -n '__postman_using_subcommand source list add remove update' -a update -d '[BETA] Update fields on an existing datasource. Only the flags you provide are changed.'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source' -s h -l help -d 'display help for command'
 # ---------- dataset source list ----------
+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
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -l json -d 'Output sources as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset source add ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s d -l dataset -d 'Dataset to add the source to — a local .dataset.yaml path or a cloud dataset id' -x
 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
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l id -d 'Override the generated source id' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l source-id -d 'Override the generated source id' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l format -d 'Override the inferred format' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l type -d 'Source kind; inferred from --file/--url when omitted' -x
 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
-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'
-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'
+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)'
+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)'
+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.'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l url -d 'HTTP(S) URL to a remote CSV/JSON file' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l host -d 'DB host (mysql/postgresql)' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l port -d 'DB port' -x
 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
-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: stored as plaintext in the YAML).' -x
+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
 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
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l table -d 'DB table name (optional)' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l slug -d 'Optional slug for the source' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset source remove ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from remove' -s d -l dataset -d 'Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from remove' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from remove' -s h -l help -d 'display help for command'
 # ---------- dataset source update ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s d -l dataset -d 'Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s n -l name -d 'Rename the source' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l format -d 'Change the format' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l file -d 'Replace the source\'s file (local-filesystem only)' -r
@@ -676,35 +696,44 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l host -d 'Update DB host (mysql/postgresql)' -x
 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
 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
-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: stored as plaintext in the YAML).' -x
+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
 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
 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
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l slug -d 'Update slug' -x
+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
 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'
 # ---------- dataset view ----------
-complete -c postman -n '__postman_using_subcommand view list run create delete update' -a list -d '[BETA] List the saved views defined on a dataset.'
+complete -c postman -n '__postman_using_subcommand view list run create delete update' -a list -d '[BETA] List the saved views defined on a dataset (local YAML path or cloud id).'
 complete -c postman -n '__postman_using_subcommand view list run create delete update' -a run -d '[BETA] Execute a saved view against a dataset and print the rows.'
-complete -c postman -n '__postman_using_subcommand view list run create delete update' -a create -d '[BETA] Add a saved view to a dataset.'
-complete -c postman -n '__postman_using_subcommand view list run create delete update' -a delete -d '[BETA] Remove a saved view from a dataset.'
-complete -c postman -n '__postman_using_subcommand view list run create delete update' -a update -d '[BETA] Update name and/or query on an existing view.'
+complete -c postman -n '__postman_using_subcommand view list run create delete update' -a create -d '[BETA] Add a saved view to a dataset (local YAML path or cloud id).'
+complete -c postman -n '__postman_using_subcommand view list run create delete update' -a delete -d '[BETA] Remove a saved view from a dataset (local YAML path or cloud id).'
+complete -c postman -n '__postman_using_subcommand view list run create delete update' -a update -d '[BETA] Update name and/or query on an existing view (local YAML path or cloud id).'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view' -s h -l help -d 'display help for command'
 # ---------- dataset view list ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -s d -l dataset -d 'Dataset whose views to list — a local .dataset.yaml path or a cloud dataset id' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -l json -d 'Output views as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset view run ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s d -l dataset -d 'Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s p -l param -d 'Positional parameter values for $1, $2, ... bindings; repeatable' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -l json -d 'Output rows as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
 # ---------- dataset view create ----------
+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
 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
 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
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -l id -d 'Override the generated view id' -x
+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
+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
 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'
-complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from create' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- dataset view delete ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from delete' -s d -l dataset -d 'Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id' -x
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from delete' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
 # ---------- dataset view update ----------
+complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s d -l dataset -d 'Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s n -l name -d 'New view name' -x
 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
+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
 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'

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.44.0)
+# Zsh completion for Postman CLI (postman v1.45.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -27,7 +27,7 @@ _postman() {
         runner) _postman_runner ;;
         spec) _postman_spec ;;
         monitor) _postman_monitor ;;
-        workspace) _postman_workspace ;;
+        workspace|ws) _postman_workspace ;;
         performance) _postman_performance ;;
         flows|fl) _postman_flows ;;
         request) _postman_request ;;
@@ -55,6 +55,7 @@ _postman_commands() {
     'spec:Lint and validate Specifications from the command line'
     'monitor:Invoke a monitor run and display results'
     'workspace:Manage workspace resources.'
+    'ws:Alias for workspace'
     'performance:Manage performance tests on your collections.'
     'flows:Manage and interact with flows.'
     'fl:Alias for flows'
@@ -149,9 +150,9 @@ _postman_collection_run() {
     '--reporter-json-structure[\[Optional\] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.]' \
     '(-n --iteration-count)'{-n,--iteration-count}'[Define the number of iterations to run]:n' \
     '(-d --iteration-data)'{-d,--iteration-data}'[Specify a data file to use for iterations (either JSON or CSV)]:path:_files -g "*.(json|csv)"' \
-    '--iteration-data-dataset[\[BETA\] Path to a .dataset.yaml whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.]:path:_files -g "*.(json|csv)"' \
+    '--iteration-data-dataset[\[BETA\] Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.]:pathOrId:_files -g "*.(json|csv)"' \
     '--iteration-data-view[\[BETA\] Name or id of the view to execute (within --iteration-data-dataset). The view'\''s result set drives one iteration per row.]:nameOrId' \
-    '--dataset[\[BETA\] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection'\''s parent repo is disabled. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
+    '--dataset[\[BETA\] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection'\''s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY\: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
     '-i[Specify the request/folder id, name, or path to run from the collection. Use a path (e.g. "FolderName/RequestName") to disambiguate items with the same name. Can be specified multiple times to run multiple items (default\: \[\])]:id' \
     '--global-var[Allows the specification of global variables via the command line, in a key=value format]:value' \
     '--env-var[Allows the specification of environment variables via the command line, in a key=value format (default\: \[\])]:value' \
@@ -368,6 +369,7 @@ _postman_workspace() {
   case $state in
     args)
       case $words[1] in
+        list) _postman_workspace_list ;;
         prepare) _postman_workspace_prepare ;;
         push) _postman_workspace_push ;;
       esac
@@ -378,12 +380,23 @@ _postman_workspace() {
 _postman_workspace_commands() {
   local -a sub
   sub=(
+    'list:List all available Postman Workspaces'
     'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
     'push:Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
   )
   _describe -t commands 'workspace command' sub
 }
 
+_postman_workspace_list() {
+  _arguments \
+    '(-f --filter)'{-f,--filter}'[Filter workspaces by name.]:name' \
+    '(-t --type)'{-t,--type}'[Filter workspaces by visibility type\: team, public, private, personal.]:type' \
+    '--verbose[Verbose output]' \
+    '--debug[Debug output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_workspace_prepare() {
   _arguments \
     '--verbose[Show detailed logging]' \
@@ -644,7 +657,7 @@ _postman_sdk_commands() {
   local -a sub
   sub=(
     'init:Create or update .postman/config.json with an SDK configuration stub.'
-    'generate:Generate a new SDK from a Postman collection or specification.'
+    'generate:Generate a new SDK from a Postman collection or specification (OpenAPI or AsyncAPI).'
     'build:Alias for generate'
     'track:Enable change tracking for a generated SDK. Adds file hashes to .manifest.json so that the next `sdk generate` can detect your edits and preserve them via 3-way merge.'
     'list:List SDK builds for a collection, extensible collection, or specification.'
@@ -1374,11 +1387,11 @@ _postman_dataset() {
 _postman_dataset_commands() {
   local -a sub
   sub=(
-    'list:\[BETA\] List dataset YAMLs under the given directory, or print summary for a single YAML file.'
-    'get:\[BETA\] Print a dataset'\''s metadata and structure summary.'
-    'query:\[BETA\] Run an ad-hoc SQL query against a dataset.'
-    'create:\[BETA\] Scaffold a new empty .dataset.yaml file at <path>.'
-    'delete:\[BETA\] Permanently remove a dataset'\''s .dataset.yaml file and its .resources/ directory.'
+    'list:\[BETA\] List local dataset YAMLs under a path, or (no path) a workspace'\''s cloud datasets.'
+    'get:\[BETA\] Print a dataset'\''s metadata and structure summary (local YAML path or cloud id).'
+    'query:\[BETA\] Run an ad-hoc SQL query against a dataset (local YAML path or cloud id).'
+    'create:\[BETA\] Scaffold a new .dataset.yaml at <path>, or (no path, with -w) create a cloud dataset.'
+    'delete:\[BETA\] Permanently remove a dataset\: a local .dataset.yaml (+ .resources/) or a cloud dataset id.'
     'source:\[BETA\] Inspect and manage a dataset'\''s datasources.'
     'view:\[BETA\] Inspect and manage saved views on a dataset.'
   )
@@ -1387,6 +1400,8 @@ _postman_dataset_commands() {
 
 _postman_dataset_list() {
   _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (cloud list)]:id' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:pathOrDir:_files -g "*.json"'
@@ -1394,26 +1409,31 @@ _postman_dataset_list() {
 
 _postman_dataset_get() {
   _arguments \
-    '--json[Output the full parsed YAML as JSON]' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--no-populate[Skip fetching datasources/views for a cloud dataset]' \
+    '--json[Output the full dataset as JSON]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '*:datasetPathOrId:'
 }
 
 _postman_dataset_query() {
   _arguments \
     '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
     '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output rows as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '*:datasetPathOrId:'
 }
 
 _postman_dataset_create() {
   _arguments \
     '(-n --name)'{-n,--name}'[Human-readable name for the dataset]:name' \
     '(-d --description)'{-d,--description}'[Optional description]:desc' \
-    '--id[Override the generated dataset id (defaults to a random v4 UUID)]:uuid' \
+    '--dataset-id[Override the generated dataset id (local only; defaults to a random v4 UUID)]:uuid' \
     '--force[Overwrite an existing file at <path>]' \
+    '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (create a cloud dataset)]:id' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:path:_files -g "*.json"'
 }
@@ -1421,9 +1441,10 @@ _postman_dataset_create() {
 _postman_dataset_delete() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
-    '--keep-resources[Delete only the YAML file; leave the .resources/ directory intact]' \
+    '--keep-resources[Delete only the YAML file; leave the .resources/ directory intact (local only)]' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '*:datasetPathOrId:'
 }
 
 _postman_dataset_source() {
@@ -1448,9 +1469,9 @@ _postman_dataset_source() {
 _postman_dataset_source_commands() {
   local -a sub
   sub=(
-    'list:\[BETA\] List the datasources defined on a dataset.'
+    'list:\[BETA\] List the datasources defined on a dataset (local YAML path or cloud id).'
     'add:\[BETA\] Add a datasource to a dataset.'
-    'remove:\[BETA\] Remove a datasource from a dataset.'
+    'remove:\[BETA\] Remove a datasource from a dataset (local YAML path or cloud id).'
     'update:\[BETA\] Update fields on an existing datasource. Only the flags you provide are changed.'
   )
   _describe -t commands 'source command' sub
@@ -1458,40 +1479,46 @@ _postman_dataset_source_commands() {
 
 _postman_dataset_source_list() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset whose sources to list — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output sources as JSON instead of a table]' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '(-h --help)'{-h,--help}'[display help for command]'
 }
 
 _postman_dataset_source_add() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
-    '--id[Override the generated source id]:uuid' \
+    '--source-id[Override the generated source id]:uuid' \
     '--format[Override the inferred format]:csv|json|mysql|postgres' \
     '--type[Source kind; inferred from --file/--url when omitted]:local|remote-url|mysql|postgresql' \
     '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
-    '--ref-only[Reference the file in place; do NOT copy into data_dir]' \
-    '--force[When copying, overwrite an existing file at the destination]' \
+    '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
+    '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
+    '--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.]' \
     '--url[HTTP(S) URL to a remote CSV/JSON file]:url' \
     '--host[DB host (mysql/postgresql)]:host' \
     '--port[DB port]:port' \
     '--user[DB user (warning\: stored as plaintext in the YAML).]:user' \
-    '--password[DB password (warning\: stored as plaintext in the YAML).]:password' \
+    '--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' \
     '--database[DB database name]:db' \
     '--table[DB table name (optional)]:table' \
     '--slug[Optional slug for the source]:slug' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:pathOrId:_files -g "*.json"'
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]'
 }
 
 _postman_dataset_source_remove() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:sourceNameOrId:'
 }
 
 _postman_dataset_source_update() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[Rename the source]:name' \
     '--format[Change the format]:csv|json|mysql|postgres' \
     '--file[Replace the source'\''s file (local-filesystem only)]:path:_files -g "*.json"' \
@@ -1501,10 +1528,11 @@ _postman_dataset_source_update() {
     '--host[Update DB host (mysql/postgresql)]:host' \
     '--port[Update DB port]:port' \
     '--user[Update DB user (warning\: stored as plaintext in the YAML).]:user' \
-    '--password[Update DB password (warning\: stored as plaintext in the YAML).]:password' \
+    '--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' \
     '--database[Update DB database name]:db' \
     '--table[Update DB table name]:table' \
     '--slug[Update slug]:slug' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:sourceNameOrId:'
 }
@@ -1532,25 +1560,28 @@ _postman_dataset_view() {
 _postman_dataset_view_commands() {
   local -a sub
   sub=(
-    'list:\[BETA\] List the saved views defined on a dataset.'
+    'list:\[BETA\] List the saved views defined on a dataset (local YAML path or cloud id).'
     'run:\[BETA\] Execute a saved view against a dataset and print the rows.'
-    'create:\[BETA\] Add a saved view to a dataset.'
-    'delete:\[BETA\] Remove a saved view from a dataset.'
-    'update:\[BETA\] Update name and/or query on an existing view.'
+    'create:\[BETA\] Add a saved view to a dataset (local YAML path or cloud id).'
+    'delete:\[BETA\] Remove a saved view from a dataset (local YAML path or cloud id).'
+    'update:\[BETA\] Update name and/or query on an existing view (local YAML path or cloud id).'
   )
   _describe -t commands 'view command' sub
 }
 
 _postman_dataset_view_list() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset whose views to list — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output views as JSON instead of a table]' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '(-h --help)'{-h,--help}'[display help for command]'
 }
 
 _postman_dataset_view_run() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-p --param)'{-p,--param}'[Positional parameter values for $1, $2, ... bindings; repeatable]:value...' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output rows as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:viewNameOrId:'
@@ -1558,23 +1589,28 @@ _postman_dataset_view_run() {
 
 _postman_dataset_view_create() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset to add the view to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[View name]:name' \
     '(-q --query)'{-q,--query}'[SQL query the view executes]:sql' \
-    '--id[Override the generated view id]:uuid' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:path:_files -g "*.json"'
+    '--view-id[Override the generated view id (local only; cloud assigns its own)]:uuid' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]'
 }
 
 _postman_dataset_view_delete() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:viewNameOrId:'
 }
 
 _postman_dataset_view_update() {
   _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the view belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[New view name]:name' \
     '(-q --query)'{-q,--query}'[New SQL query]:sql' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:viewNameOrId:'
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli-completion",
-  "version": "1.44.0",
+  "version": "1.45.0",
   "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
   "type": "module",
   "bin": {