postman-cli-completion 1.66.0 → 1.71.0

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.66.0)
+# Zsh completion for Postman CLI (postman v1.71.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -43,13 +43,14 @@ _postman() {
         sdk) _postman_sdk ;;
         mock) _postman_mock ;;
         application|app) _postman_application ;;
-        simulate) _postman_simulate ;;
+        simulation) _postman_simulation ;;
         describe) _postman_describe ;;
         context-graph) _postman_context_graph ;;
         search) _postman_search ;;
         webhook) _postman_webhook ;;
         dataset) _postman_dataset ;;
         dependency) _postman_dependency ;;
+        secret) _postman_secret ;;
       esac
       ;;
   esac
@@ -68,7 +69,7 @@ _postman_commands() {
     'skills:Check and update the agent skills in this repository.'
     'collection:Run and test your Postman collections directly from the command line.'
     'environment:Work with local Postman environments from the command line. Also read cloud environments by ID.'
-    'globals:Work with local Postman globals from the command line.'
+    'globals:Work with local Postman globals from the command line. Also read cloud globals by workspace.'
     'api:Publish and test your APIs directly from the command line'
     'runner:Where your monitors execute\: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team.'
     'spec:Lint and validate Specifications from the command line'
@@ -84,13 +85,14 @@ _postman_commands() {
     'mock:Create, run, and manage Postman mocks — in your repository or in Postman cloud.'
     'application:Application-level commands\: initialise config and run tests.'
     'app:Alias for application'
-    'simulate:Start mock servers with simulated failure scenarios.'
+    'simulation:Create, run and manage simulations — serve several mocks behind one address.'
     'describe:\[Beta\] Get API context for AI coding agents directly from the command line.'
     'context-graph:Ask natural-language questions about your team'\''s Context Graph.'
     'search:Search for Postman element types (requests, collections, workspaces, and more).'
     'webhook:Create and manage Postman webhooks.'
     'dataset:Work with Postman datasets in local YAML files or the cloud.'
     'dependency:Manage workspace dependencies (Postman entities reused from other workspaces).'
+    'secret:Create and manage Postman secrets in a team'\''s shared vault.'
   )
   _describe -t commands 'postman command' commands
 }
@@ -124,8 +126,8 @@ _postman_init() {
     '--no-fetch[Use the skills bundled with this CLI instead of fetching the latest]' \
     '--spec[Which spec is authoritative, when more than one could be]:path:_files -g "*.(yaml|yml|json)"' \
     '--visibility[Create and bind a workspace non-interactively (personal, team)]:status' \
-    '--no-cloud[Skip the workspace step entirely]' \
-    '--report-events[Send init analytics to Postman (requires login)]' \
+    '(-y --yes)'{-y,--yes}'[Accept the default for every question instead of asking or stopping]' \
+    '--report-events[Dispatch init events to the API Catalog and Application Inventory ingestion pipelines (requires login)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:path:_files -g "*.json"'
 }
@@ -209,10 +211,14 @@ _postman_collection() {
         lint) _postman_collection_lint ;;
         ai-readiness) _postman_collection_ai_readiness ;;
         get) _postman_collection_get ;;
+        delete) _postman_collection_delete ;;
+        publish) _postman_collection_publish ;;
         generate) _postman_collection_generate ;;
         sync) _postman_collection_sync ;;
         request) _postman_collection_request ;;
         folder) _postman_collection_folder ;;
+        example) _postman_collection_example ;;
+        import) _postman_collection_import ;;
         list) _postman_collection_list ;;
         run) _postman_collection_run ;;
       esac
@@ -228,10 +234,14 @@ _postman_collection_commands() {
     'lint:Run linting on a local v3 collection at the given file or directory path.'
     'ai-readiness:Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
     'get:Fetch a Postman collection in the V3 format and print it.'
+    'delete:Delete a cloud collection by id or a local collection directory by path. Prompts unless --yes is passed.'
+    'publish:Publish a cloud collection'\''s documentation (or request Community Manager approval).'
     'generate:Generate artifacts from a collection.'
     'sync:Sync artifacts generated from a collection.'
-    'request:Add, update, or remove requests in a local v3 collection.'
-    'folder:Add, update, or remove folders in a local v3 collection.'
+    'request:Add, get, update, or remove requests in a local v3 collection.'
+    'folder:Add, get, update, or remove folders in a local v3 collection.'
+    'example:Add, update, remove, get, or list examples (saved responses) under a request.'
+    'import:Import a cURL or HAR source into a v3 collection (local, or cloud with --workspace).'
     'list:List collections\: your local project'\''s collections by default, or a Postman cloud workspace'\''s collections with --workspace.'
     'run:Initiate a Postman collection run from a given ID or path.'
   )
@@ -280,6 +290,29 @@ _postman_collection_get() {
     '*:id:'
 }
 
+_postman_collection_delete() {
+  _arguments \
+    '(-y --yes)'{-y,--yes}'[Delete without asking for confirmation first]' \
+    '--api-key[Postman API key, used when deleting a cloud collection]:key:_files -g "*.(pem|crt|key)"' \
+    '--verbose[Verbose output]' \
+    '--json[Output the result as JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:idOrPath:'
+}
+
+_postman_collection_publish() {
+  _arguments \
+    '--target[Where to publish (default\: documentation) (default\: "documentation")]:name' \
+    '--environment[Cloud environment UID to bind to the docs]:environment-id:_files -g "*.json"' \
+    '--title[SEO title meta tag (max 120 characters)]:seo-title' \
+    '--description[SEO description meta tag (max 320 characters)]:seo-description' \
+    '--note[Note for Community Managers (request-to-publish only)]:text' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Machine-readable JSON on stdout (errors on stderr)]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:collection-id:_files -g "*.json"'
+}
+
 _postman_collection_generate() {
   local context state state_descr line
   typeset -A opt_args
@@ -357,6 +390,7 @@ _postman_collection_request() {
     args)
       case $words[1] in
         add) _postman_collection_request_add ;;
+        get) _postman_collection_request_get ;;
         update) _postman_collection_request_update ;;
         rm|remove) _postman_collection_request_rm ;;
       esac
@@ -368,6 +402,7 @@ _postman_collection_request_commands() {
   local -a sub
   sub=(
     'add:Add an empty request to a local v3 collection (set its details later with `update`).'
+    'get:Show a request (any type) in a v3 collection\: its own fields, with examples and messages as references.'
     'update:Update a request in a v3 collection (only the fields you pass).'
     'rm:Remove a request (any type) from a v3 collection.'
     'remove:Alias for rm'
@@ -386,14 +421,25 @@ _postman_collection_request_add() {
     '*:request-name:'
 }
 
+_postman_collection_request_get() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path. Required locally; optional in cloud mode (id only).]:id|name' \
+    '--folder[Folder to scope a bare-name request selector, e.g. "Users/Admin" (local mode only).]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:request:'
+}
+
 _postman_collection_request_update() {
   _arguments \
     '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
     '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
     '--rename[Rename the request (moves its file). Any request type.]:name' \
-    '--url[Request URL. Any request type.]:url' \
+    '--url[Request URL; its query string becomes the query parameters. Any request type.]:url' \
     '--method[HTTP method (http requests only).]:method' \
-    '--param[Replace query parameters. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--param[Replace all query parameters and the url query string. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--clear-params[Remove all query parameters and the url query string (http requests only).]' \
     '(-d --body)'{-d,--body}'[Request payload (inline, @file, or - for stdin), interpreted by request type. For http, an optional "<type>\:" prefix picks the content type\: json/text/xml/html/javascript, file\:<path>, urlencoded\:key=v&k2=v2, or formdata\:key=v&file=@path.]:body' \
     '--variables[GraphQL variables JSON (graphql requests only).]:json' \
     '--description[Request description.]:text' \
@@ -429,6 +475,7 @@ _postman_collection_folder() {
     args)
       case $words[1] in
         add) _postman_collection_folder_add ;;
+        get) _postman_collection_folder_get ;;
         update) _postman_collection_folder_update ;;
         rm|remove) _postman_collection_folder_rm ;;
       esac
@@ -440,6 +487,7 @@ _postman_collection_folder_commands() {
   local -a sub
   sub=(
     'add:Add an empty folder to a local v3 collection (set its details later with `update`).'
+    'get:Show a folder in a v3 collection\: its own fields and its direct children as references.'
     'update:Update a folder in a v3 collection (only the fields you pass).'
     'rm:Remove a folder from a v3 collection (recursive\: removes everything inside it).'
     'remove:Alias for rm'
@@ -457,6 +505,16 @@ _postman_collection_folder_add() {
     '*:folder-name:'
 }
 
+_postman_collection_folder_get() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path. Required locally; optional in cloud mode (id only).]:id|name' \
+    '--folder[Parent folder to scope a bare-name selector, e.g. "Users" (local mode only).]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:folder:'
+}
+
 _postman_collection_folder_update() {
   _arguments \
     '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
@@ -482,6 +540,125 @@ _postman_collection_folder_rm() {
     '*:folder:'
 }
 
+_postman_collection_example() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_collection_example_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        add) _postman_collection_example_add ;;
+        update) _postman_collection_example_update ;;
+        rm|remove) _postman_collection_example_rm ;;
+        get) _postman_collection_example_get ;;
+        list) _postman_collection_example_list ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_collection_example_commands() {
+  local -a sub
+  sub=(
+    'add:Add an empty example under a request (defaults to 200 OK; set details later with `update`).'
+    'update:Update an example (only the fields you pass).'
+    'rm:Remove an example from a request.'
+    'remove:Alias for rm'
+    'get:Get a single example.'
+    'list:List examples under a request.'
+  )
+  _describe -t commands 'example command' sub
+}
+
+_postman_collection_example_add() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path. Required.]:id|name' \
+    '--request[Parent request (required). Local\: name/path/id; cloud\: id.]:id|name|path' \
+    '--folder[Folder to scope the request selector, e.g. "Users/Admin".]:id|name|path' \
+    '--type[Example type\: http (default). (default\: "http")]:type' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:example-name:'
+}
+
+_postman_collection_example_update() {
+  _arguments \
+    '--collection[Target collection. Required.]:id|name' \
+    '--request[Parent request (optional; disambiguates local names / --copy-request).]:id|name|path' \
+    '--folder[Folder to scope the request selector.]:id|name|path' \
+    '--status-code[HTTP status code.]:code' \
+    '--status-text[HTTP status text.]:text' \
+    '(-d --body)'{-d,--body}'[Response body as contentType\:content.]:body' \
+    '--headers[Replace response headers. Repeatable. (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--description[Example description.]:text' \
+    '--rename[Rename the example.]:name' \
+    '--url[Example request snapshot URL.]:url' \
+    '--method[Example request snapshot method.]:method' \
+    '--request-headers[Replace request-snapshot headers. Repeatable. (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--request-param[Replace request-snapshot query params. Repeatable. (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--request-body[Example request snapshot body.]:body' \
+    '--copy-request[Refresh example.request from the parent request.]' \
+    '--clear-request[Remove the example.request snapshot.]' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--type[Example type for cloud mode\: http. (default\: "http")]:type' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:example:'
+}
+
+_postman_collection_example_rm() {
+  _arguments \
+    '--collection[Target collection. Required.]:id|name' \
+    '--request[Parent request (optional; disambiguates local names).]:id|name|path' \
+    '--folder[Folder to scope the request selector.]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--type[Example type for cloud mode\: http. (default\: "http")]:type' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:example:'
+}
+
+_postman_collection_example_get() {
+  _arguments \
+    '--collection[Target collection. Required.]:id|name' \
+    '--request[Parent request (optional; disambiguates local names).]:id|name|path' \
+    '--folder[Folder to scope the request selector.]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--type[Example type for cloud mode\: http. (default\: "http")]:type' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:example:'
+}
+
+_postman_collection_example_list() {
+  _arguments \
+    '--collection[Target collection. Required.]:id|name' \
+    '--request[Parent request (required).]:id|name|path' \
+    '--folder[Folder to scope the request selector.]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--type[Example type for cloud mode\: http. (default\: "http")]:type' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_collection_import() {
+  _arguments \
+    '--type[Source format\: curl or har. Auto-detected from the extension/content when omitted.]:format' \
+    '--name[Collection display name. Defaults to a per-format fallback.]:name' \
+    '(-o --output)'{-o,--output}'[Output directory for the local collection (default\: postman/collections/<name>).]:dir:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Create the collection in a Postman cloud workspace by id (cloud mode).]:id' \
+    '--force[Overwrite an existing local target directory.]' \
+    '--timeout[Max time for a cloud import, in milliseconds (default 120000).]:ms' \
+    '--verbose[Verbose output (cloud import diagnostics).]' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:src:'
+}
+
 _postman_collection_list() {
   _arguments \
     '(-w --workspace)'{-w,--workspace}'[List a Postman cloud workspace'\''s collections by id. Omit to list the local project'\''s collections.]:workspaceId' \
@@ -496,20 +673,18 @@ _postman_collection_run() {
   _arguments \
     '(-e --environment)'{-e,--environment}'[Specify an Id or path to a Postman Environment]:path:_files -g "*.json"' \
     '(-g --globals)'{-g,--globals}'[Specify an Id or path to a file containing Postman Globals]:path:_files -g "*.json"' \
-    '(-r --reporters)'{-r,--reporters}'[Specify the reporters to use for the run\: cli,json,junit,html. For multiple reporters, provide their names as a comma-separated list (E.g., -r cli,json) (default\: \["cli"\])]:reporter:(cli json junit html)' \
-    '--output[Write a YAML-based run report to the given folder. Creates a paired `<prefix>.collection-run-summary.yaml` (refreshed during the run) and streaming `<prefix>.collection-run-executions.yaml`, where prefix defaults to `<collection-slug>-<timestamp>`. Gotcha\: --output streams run data to file and cannot be combined with the built-in reporters (-r/--reporter-*); doing so exits with an error. This keeps large runs from buffering an entire report in memory.]:folder' \
-    '--reporter-json-structure[\[Optional\] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.]' \
+    '--output[Write a YAML-based run report to the given folder. Creates a paired `<prefix>.collection-run-summary.yaml` (refreshed during the run) and streaming `<prefix>.collection-run-executions.yaml`, where prefix defaults to `<collection-slug>-<timestamp>`. Gotcha\: --output streams run data to file, which keeps large runs from buffering an entire report in memory.]:folder' \
     '(-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 (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 collection scripts and local mock handlers 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"' \
+    '--iteration-data-dataset[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[Name or id of the view to execute (within --iteration-data-dataset). The view'\''s result set drives one iteration per row.]:nameOrId' \
+    '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to collection scripts and local mock handlers 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' \
     '--integration-id[Specify the integration id for the report. (Only supported in the US region)]:integration-id' \
     '--postman-api-key[API Key used to load the resources from the Postman API (Only supported in the US region, use '\''postman login --region'\'' to authenticate instead)]:apiKey' \
-    '--alias[Specify the alias of the API key to fetch remote resources using it.]:alias' \
+    '--alias[Specify the alias of the API key to fetch remote resources using it. (This option is discontinued and will be removed in a future release.)]:alias' \
     '--bail[Specify whether or not to gracefully stop a collection run on encountering an error and whether to end the run with an error based on the optional modifier]:modifiers:(folder failure)' \
     '--ignore-redirects[Prevents Postman CLI from automatically following 3XX redirect responses]' \
     '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Specify whether or not to override the default exit code for the current run]' \
@@ -537,20 +712,9 @@ _postman_collection_run() {
     '--simulation[Simulation id to record start history against when using --simulate.]:id' \
     '--simulate-workspace[Workspace that owns the --simulate run, for recording its start history.]:id' \
     '--no-simulate-history[Do not record the --simulate run in the simulation'\''s start history.]' \
-    '--report-events[Upload results for git-native v3 collection runs. Analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '--reporter-json-export[Path to save the report for the given reporter.]:value:_files -g "*.(json|xml|html)"' \
-    '--reporter-junit-export[Path to save the report for the given reporter.]:value:_files -g "*.(json|xml|html)"' \
-    '--reporter-html-export[Path to save the report for the given reporter.]:value:_files -g "*.(json|xml|html)"' \
-    '--reporter-json-omitRequestBodies[Remove all request bodies from the report.]' \
-    '--reporter-html-omitRequestBodies[Remove all request bodies from the report.]' \
-    '--reporter-json-omitResponseBodies[Remove all response bodies from the report.]' \
-    '--reporter-html-omitResponseBodies[Remove all response bodies from the report.]' \
-    '--reporter-json-omitHeaders[Remove all request and response headers from the report.]' \
-    '--reporter-html-omitHeaders[Remove all request and response headers from the report.]' \
-    '--reporter-json-omitAllHeadersAndBody[Remove all request/response headers and bodies from the report.]' \
-    '--reporter-html-omitAllHeadersAndBody[Remove all request/response headers and bodies from the report.]' \
+    '--report-events[Dispatch run events, including git-native v3 collection run results, to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch run events to the API Catalog and Application Inventory ingestion pipelines]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
     '*:collectionId/Path:_files -g "*.json"'
 }
 
@@ -567,6 +731,7 @@ _postman_environment() {
         new) _postman_environment_new ;;
         list) _postman_environment_list ;;
         get) _postman_environment_get ;;
+        delete) _postman_environment_delete ;;
         var) _postman_environment_var ;;
         lint) _postman_environment_lint ;;
       esac
@@ -580,6 +745,7 @@ _postman_environment_commands() {
     'new:Scaffold a local environment file, or create one in a Postman workspace with --workspace.'
     'list:List environments in a Postman workspace.'
     'get:Read an environment by ID or local environment file path.'
+    'delete:Delete an environment by ID or local environment file path. Prompts unless --yes is passed.'
     'var:Read and update environment variables.'
     'lint:Run linting on a local Postman environment at the given file or directory path.'
   )
@@ -610,7 +776,15 @@ _postman_environment_get() {
   _arguments \
     '--verbose[Verbose output]' \
     '--json[JSON output]' \
-    '--show-secrets[Show secret variable values in output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:environment:_files -g "*.json"'
+}
+
+_postman_environment_delete() {
+  _arguments \
+    '(-y --yes)'{-y,--yes}'[Delete without asking for confirmation first]' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:environment:_files -g "*.json"'
 }
@@ -636,7 +810,7 @@ _postman_environment_var() {
 _postman_environment_var_commands() {
   local -a sub
   sub=(
-    'set:Set one variable in an environment.'
+    'set:Set one variable in an environment, or link it to a shared-vault secret.'
     'get:Read one variable value from an environment.'
     'unset:Remove one variable from an environment.'
   )
@@ -646,6 +820,9 @@ _postman_environment_var_commands() {
 _postman_environment_var_set() {
   _arguments \
     '(-e --environment)'{-e,--environment}'[Cloud Environment ID or local environment file path.]:environment:_files -g "*.json"' \
+    '--secret-id[Link this variable to a shared-vault secret instead of an inline value (from `secret create`'\''s output).]:id' \
+    '--vault-id[Vault id for --secret-id (auto-resolved from --workspace when omitted).]:id' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace to resolve --vault-id from when --secret-id is given without --vault-id (falls back to .postman/resources.yaml).]:workspaceId' \
     '--verbose[Verbose output]' \
     '--json[JSON output]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -657,7 +834,6 @@ _postman_environment_var_get() {
     '(-e --environment)'{-e,--environment}'[Cloud Environment ID or local environment file path.]:environment:_files -g "*.json"' \
     '--verbose[Verbose output]' \
     '--json[JSON output]' \
-    '--show-secrets[Show secret variable values in output]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:key:_files -g "*.json"'
 }
@@ -689,6 +865,8 @@ _postman_globals() {
   case $state in
     args)
       case $words[1] in
+        get) _postman_globals_get ;;
+        var) _postman_globals_var ;;
         lint) _postman_globals_lint ;;
       esac
       ;;
@@ -698,11 +876,82 @@ _postman_globals() {
 _postman_globals_commands() {
   local -a sub
   sub=(
+    'get:Read local workspace globals from the default file, or cloud globals with --workspace.'
+    'var:Read and update variables in the workspace globals singleton.'
     'lint:Run linting on a local Postman globals file at the given file or directory path.'
   )
   _describe -t commands 'globals command' sub
 }
 
+_postman_globals_get() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID to read globals from.]:workspaceId' \
+    '--workspace-path[Local Postman workspace path. Defaults to the current directory.]:path:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_globals_var() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_globals_var_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        set) _postman_globals_var_set ;;
+        get) _postman_globals_var_get ;;
+        unset) _postman_globals_var_unset ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_globals_var_commands() {
+  local -a sub
+  sub=(
+    'set:Set one variable in local workspace globals, or link it to a shared-vault secret.'
+    'get:Read one variable from local workspace globals, or cloud globals with --workspace.'
+    'unset:Remove one variable from local workspace globals, or cloud globals with --workspace.'
+  )
+  _describe -t commands 'var command' sub
+}
+
+_postman_globals_var_set() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID whose cloud globals should be updated.]:workspaceId' \
+    '--secret-id[Link this variable to a shared-vault secret instead of an inline value (from `secret create`'\''s output).]:id' \
+    '--vault-id[Vault id for --secret-id (auto-resolved from --workspace when omitted).]:id' \
+    '--workspace-path[Local Postman workspace path. Defaults to the current directory.]:path:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:value:'
+}
+
+_postman_globals_var_get() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID whose cloud globals should be read.]:workspaceId' \
+    '--workspace-path[Local Postman workspace path. Defaults to the current directory.]:path:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:key:_files -g "*.json"'
+}
+
+_postman_globals_var_unset() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID whose cloud globals should be updated.]:workspaceId' \
+    '--workspace-path[Local Postman workspace path. Defaults to the current directory.]:path:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:key:_files -g "*.json"'
+}
+
 _postman_globals_lint() {
   _arguments \
     '(-f --fail-severity)'{-f,--fail-severity}'[Exit with failure if diagnostics at this level or above are present. \[choices\: "error", "warning"\] (default\: "error")]:value' \
@@ -798,8 +1047,8 @@ _postman_runner_start() {
     '--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 -/' \
     '--metrics[Enable the metrics server for health checks]' \
     '--metrics-port[Port for the metrics server (default\: "9090")]:port' \
-    '--report-events[Accepted for compatibility; run events are reported by default]' \
-    '--no-report-events[Do not report run events to Postman]' \
+    '--report-events[Dispatch run events to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch run events to the API Catalog and Application Inventory ingestion pipelines]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -849,7 +1098,7 @@ _postman_spec_commands() {
     'ai-readiness:Score an OpenAPI specification for AI readiness by ID or local file path.'
     'list:List local spec files under a path, or (no path) a workspace'\''s cloud specs.'
     'get:Read a spec definition, including every file of a multi-file spec.'
-    'file:Add, update, or remove files in a spec (cloud ID or local directory).'
+    'file:Get, add, update, or remove files in a spec (cloud ID or local directory).'
     'create:Create a new spec in a workspace, or (with path) scaffold a local spec file.'
     'generate:Generate artifacts from a specification.'
     'sync:Sync a generated collection with its source specification.'
@@ -863,8 +1112,8 @@ _postman_spec_lint() {
     '(-f --fail-severity)'{-f,--fail-severity}'[Results of this level or above will trigger a failure exit code. \[choices\: "error", "warning", "info", "hint"\] (default\: "ERROR")]:value' \
     '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "json", "csv"\]]:value' \
     '--workspace-id[The workspace ID to use for fetching governance rulesets.]:value' \
-    '--report-events[Accepted for compatibility; analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
+    '--report-events[Dispatch events to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch events to the API Catalog and Application Inventory ingestion pipelines]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:spec:'
 }
@@ -905,6 +1154,7 @@ _postman_spec_file() {
   case $state in
     args)
       case $words[1] in
+        get) _postman_spec_file_get ;;
         add) _postman_spec_file_add ;;
         update) _postman_spec_file_update ;;
         rm) _postman_spec_file_rm ;;
@@ -916,6 +1166,7 @@ _postman_spec_file() {
 _postman_spec_file_commands() {
   local -a sub
   sub=(
+    'get:Show a file in a spec\: its path, size and content.'
     'add:Add a new file to a spec.'
     'update:Update an existing file in a spec.'
     'rm:Remove a file from a spec.'
@@ -923,6 +1174,14 @@ _postman_spec_file_commands() {
   _describe -t commands 'file command' sub
 }
 
+_postman_spec_file_get() {
+  _arguments \
+    '--json[Output as JSON]' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:filePath:_files -g "*.json"'
+}
+
 _postman_spec_file_add() {
   _arguments \
     '(-c --content)'{-c,--content}'[File content (reads from stdin if omitted)]:content' \
@@ -1023,6 +1282,7 @@ _postman_spec_sync_collection() {
   _arguments \
     '--collection-id[Collection ID to sync (required for cloud mode)]:id' \
     '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '--force[Overwrite hand-written scripts that the spec would otherwise drop]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:spec:'
 }
@@ -1066,7 +1326,7 @@ _postman_monitor_commands() {
   sub=(
     'run:Invoke a monitor run and display results.'
     'create:Create a collection-based monitor.'
-    'update:Update a monitor'\''s schedule, runner, notifications or run options.'
+    'update:Update a monitor'\''s schedule, runner, notifications, request selection or run options.'
     'delete:Permanently delete a monitor. Prompts for confirmation unless --yes is passed.'
     'jobs:Inspect a monitor'\''s jobs and their per-region runs.'
     'runs:Inspect a monitor run'\''s attempts.'
@@ -1099,6 +1359,7 @@ _postman_monitor_create() {
     '--schedule[Cron expression for the monitor'\''s schedule]:cron' \
     '--timezone[Time zone for --schedule, for example America/New_York (defaults to the host machine'\''s own zone)]:tz' \
     '--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' \
+    '(-i --item)'{-i,--item}'[Id of a request or folder in the collection to run, in the order given (repeatable; ids only, not names or paths; defaults to every request; list ids with `postman collection get <collection-id> --json`) (default\: \[\])]:id' \
     '--notify-email[Email to notify on a run failure or error (repeatable) (default\: \[\])]:email' \
     '--notification-limit[Consecutive failure notifications to send before muting them]:n' \
     '--retry[Times to retry a failed run]:n' \
@@ -1124,6 +1385,8 @@ _postman_monitor_update() {
     '--schedule[New cron expression for the monitor'\''s schedule]:cron' \
     '--timezone[Time zone for --schedule, for example America/New_York (defaults to the host machine'\''s own zone)]:tz' \
     '--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' \
+    '(-i --item)'{-i,--item}'[Id of a request or folder in the collection to run, in the order given (repeatable; ids only, not names or paths; replaces the saved selection; list ids with `postman collection get <collection-id> --json`) (default\: \[\])]:id' \
+    '--clear-items[Remove the saved selection so the monitor runs every request in its collection]' \
     '--notify-email[Email to notify on a run failure or error (repeatable; replaces the current list) (default\: \[\])]:email' \
     '--clear-notifications[Remove every notification recipient]' \
     '(-e --environment)'{-e,--environment}'[Environment to run the monitored collection with (replaces the current one)]:id' \
@@ -1340,6 +1603,7 @@ _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' \
+    '--cursor[Fetch the page of workspaces that follows this cursor.]:cursor' \
     '--verbose[Verbose output]' \
     '--debug[Debug output]' \
     '--json[JSON output]' \
@@ -1349,6 +1613,7 @@ _postman_workspace_list() {
 _postman_workspace_prepare() {
   _arguments \
     '--verbose[Show detailed logging]' \
+    '--json[Print the outcome as machine-readable JSON.]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -1357,9 +1622,10 @@ _postman_workspace_push() {
     '--no-prepare[Skip ID validation and auto-fix before pushing]' \
     '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
     '--push-strategy[Push strategy. "force-sync"\: mirror the whole workspace — also DELETE cloud entities that have no local counterpart (destructive). Defaults to "default" (create/update only).]:strategy' \
+    '--json[Print the outcome as machine-readable JSON. Implies non-interactive\: use --yes to actually push.]' \
     '--verbose[Show detailed logging]' \
-    '--report-events[Accepted for compatibility; analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
+    '--report-events[Dispatch events to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch events to the API Catalog and Application Inventory ingestion pipelines]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -1392,6 +1658,7 @@ _postman_workspace_create() {
     '--path[Directory to bind (defaults to the current directory)]:dir:_files -g "*.json"' \
     '--no-connect[Create the workspace without binding it to the repository]' \
     '--force[Create even when a workspace is already recorded for this repo]' \
+    '--json[Print the created workspace as machine-readable JSON.]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -1409,6 +1676,7 @@ _postman_workspace_pull() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
     '--source-workspace[Pull from a different source workspace.]:workspaceId' \
+    '--json[Print the outcome as machine-readable JSON. Implies non-interactive\: use --yes to actually pull.]' \
     '--verbose[Show detailed logging]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:workspaceId:'
@@ -1417,6 +1685,7 @@ _postman_workspace_pull() {
 _postman_workspace_connect_git() {
   _arguments \
     '--verbose[Show detailed logging]' \
+    '--json[Print the outcome as machine-readable JSON.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:path:_files -g "*.json"'
 }
@@ -1425,6 +1694,7 @@ _postman_workspace_disconnect_git() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
     '--verbose[Show detailed logging]' \
+    '--json[Print the outcome as machine-readable JSON. Requires --yes to actually disconnect.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:workspaceId:'
 }
@@ -1485,6 +1755,7 @@ _postman_performance() {
       case $words[1] in
         run) _postman_performance_run ;;
         list) _postman_performance_list ;;
+        get) _postman_performance_get ;;
       esac
       ;;
   esac
@@ -1495,6 +1766,7 @@ _postman_performance_commands() {
   sub=(
     'run:Run a performance test on a collection'
     'list:List past performance runs for a collection, newest first.'
+    'get:Get one performance run by ID.'
   )
   _describe -t commands 'performance command' sub
 }
@@ -1505,9 +1777,12 @@ _postman_performance_run() {
     '(-g --globals)'{-g,--globals}'[Specify an Id to a Postman Globals]:id' \
     '--setup-collection[Collection UID to run before the performance test]:id' \
     '--teardown-collection[Collection UID to run after the performance test]:id' \
-    '--vu-count[Number of virtual users (default\: 20)]:count' \
+    '--peak-vu[Peak (maximum) virtual users (default\: 20)]:count' \
+    '--vu-count[Older name for --peak-vu]:count' \
+    '--base-vu[Base (floor) virtual users the run starts from, 1 or more. Not for --load-profile fixed, which runs flat]:count' \
     '(-d --duration)'{-d,--duration}'[Duration of the performance test in minutes (default\: 1)]:minutes' \
     '(-p --load-profile)'{-p,--load-profile}'[Load profile type\: fixed, ramp-up, spike, peak (default\: "ramp-up")]:profile' \
+    '(-s --load-segments)'{-s,--load-segments}'[Duration of each phase of the profile, comma separated, in order. ramp-up takes 2, spike 3, peak 4; fixed takes none. See the load-segment section below for which position is which phase]:durations' \
     '--data-file[Path to a JSON or CSV data file to use with the collection]:path:_files -g "*.json"' \
     '--ssl-client-cert-list[Path to a client certificates configuration file (JSON). Local runner only.]:path:_files -g "*.(pem|crt|key)"' \
     '--ssl-client-cert[Path to a client certificate (PEM) for mTLS targets. Local runner only.]:path:_files -g "*.(pem|crt|key)"' \
@@ -1521,7 +1796,8 @@ _postman_performance_run() {
     '--postman-api-key[API Key used to load the resources from the Postman API (Only supported in the US region, use '\''postman login --region'\'' to authenticate instead)]:apiKey' \
     '--output[Output format for live results\: auto (default, interactive dashboard) or ndjson (one JSON object per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default\: "auto")]:format' \
     '--runner[Runner to execute the performance test on\: local, postman-cloud, or postman-cloud-static-ip (egress from your account region'\''s static-IP cluster) (default\: local)]:runner' \
-    '--pass-if[Pass condition in format\: function(metric, value). Functions\: less_than, greater_than, less_than_eq, greater_than_eq. Metrics\: avg, p90, p95, p99, error_rate, rps. Example\: less_than(p95, 500) or less_than(error_rate, 5)]:condition' \
+    '--disable-unicode[Forces Unicode compliant symbols to be replaced by their plain text equivalents]' \
+    '--pass-if[Pass condition in format\: function(metric, value) (repeatable; all conditions must hold). Functions\: less_than, greater_than, less_than_eq, greater_than_eq. Metrics\: avg, p90, p95, p99, error_rate, rps. Example\: less_than(p95, 500)]:condition' \
     '--use-mock[Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format\: "<{{var}}|host> mock|mock-server\:<path|id> \[scenario\]" (default\: \[\])]:mapping' \
     '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the handlers of the local mocks started by --use-mock as pm.datasets(<id>). Local runner only. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -1532,12 +1808,22 @@ _postman_performance_list() {
   _arguments \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID whose performance runs to list]:id' \
     '--cursor[Pagination cursor from a previous page'\''s response]:token' \
-    '--json[Output as JSON instead of a table]' \
+    '--output[Output format\: table (default) or json (default\: "table")]:format' \
+    '--json[Alias for --output json]' \
     '--timeout[Milliseconds to wait for the service before failing (default\: "30000")]:ms' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:id:'
 }
 
+_postman_performance_get() {
+  _arguments \
+    '--output[Output format\: table (default) or json (default\: "table")]:format' \
+    '--json[Alias for --output json]' \
+    '--timeout[Milliseconds to wait for the service before failing (default\: "30000")]:ms' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:runId:'
+}
+
 _postman_flows() {
   local context state state_descr line
   typeset -A opt_args
@@ -1632,8 +1918,8 @@ _postman_flows_run() {
     '--reporters[Save a test results report to a file (supported\: html)]:format' \
     '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Specify whether or not to override the default exit code for the current run]' \
     '--workspace[Workspace ID required for flows that contain connector blocks. Find it in the Postman app URL\: https\://postman.com/workspace/<workspaceId>]:workspaceId' \
-    '--report-events[Accepted for compatibility; analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
+    '--report-events[Dispatch events to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch events to the API Catalog and Application Inventory ingestion pipelines]' \
     '--verbose[Verbose output]' \
     '--debug[Debug output]' \
     '--json[JSON output]' \
@@ -1685,6 +1971,14 @@ _postman_request() {
     '--redirects-max[Maximum number of redirects to follow. Default is unlimited. Useful for preventing redirect loops.]:n' \
     '--redirects-follow-method[Preserves the original HTTP method when following redirects. By default, redirects are followed with GET method.]' \
     '--redirects-remove-referrer[Removes the Referer header when following redirects. By default, Referer header is sent with redirects.]' \
+    '(-k --insecure)'{-k,--insecure}'[Disable SSL certificate verification.]' \
+    '--ssl-client-cert-list[Specify the path to client certificate configurations (JSON).]:path:_files -g "*.(pem|crt|key)"' \
+    '--ssl-client-cert[Specify the path to a client certificate (PEM).]:path:_files -g "*.(pem|crt|key)"' \
+    '--ssl-client-key[Specify the path to a client certificate private key.]:path:_files -g "*.(pem|crt|key)"' \
+    '--ssl-client-passphrase[Specify the client certificate passphrase (for protected key).]:passphrase' \
+    '--ssl-extra-ca-certs[Specify additional trusted CA certificates (PEM).]:path:_files -g "*.(pem|crt|key)"' \
+    '--cookie-jar[Specify the path to a custom cookie jar (serialized tough-cookie JSON).]:path:_files -g "*.json"' \
+    '--export-cookie-jar[Export the cookie jar to a file after completing the request.]:path:_files -g "*.json"' \
     '--retry[Number of retry attempts for failed requests (4xx, 5xx, network errors). Useful for flaky endpoints or rate-limited APIs. (default\: 0)]:n' \
     '--retry-delay[Delay between retry attempts in milliseconds. (default\: 1000)]:ms' \
     '--script-pre-request[Add JavaScript script to run before the request. Can be inline JS or @filepath to load from file. Scripts have access to pm.* APIs. Example\: --script-pre-request "pm.environment.set('\''timestamp'\'', Date.now());" or --script-pre-request @setup.js]:script' \
@@ -1694,8 +1988,8 @@ _postman_request() {
     '--verbose[Show detailed request and response information including headers, body, and metadata.]' \
     '--response-only[suppress all output except response body. Useful for piping to other commands.]' \
     '--debug[Debug mode\: show detailed execution information including retry attempts, redirects, and timing breakdowns.]' \
-    '--report-events[Accepted for compatibility; analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
+    '--report-events[Dispatch events to the API Catalog and Application Inventory ingestion pipelines (on by default)]' \
+    '--no-report-events[Do not dispatch events to the API Catalog and Application Inventory ingestion pipelines]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '--auth-basic-username[Supply authentication parameters dynamically.]:value' \
     '--auth-basic-password[Supply authentication parameters dynamically.]:value' \
@@ -1938,6 +2232,7 @@ _postman_mock_run() {
     '--api-key[Postman API key, used with a Postman cloud id (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-w --workspace)'{-w,--workspace}'[Workspace that owns the run, for recording its start history. Auto-resolved for a Postman cloud id; required to record history for a path.]:id' \
     '--no-history[Do not record this run in the mock'\''s start history.]' \
+    '--output[Live output format\: auto (default, human-readable logs) or ndjson (one JSON event per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default\: "auto")]:format' \
     '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the mock'\''s handlers as pm.datasets(<id>). (default\: \[\])]:pathOrDir:_files -g "*.json"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockIdOrPath:_files -g "*.json"'
@@ -2052,9 +2347,9 @@ _postman_application_test() {
     '--network-log[Directory to scan for captured artifacts, or a direct path to a Playwright JSON report / NDJSON capture file. When a directory is given, recursively discovers `*.json` Playwright reports plus their `trace.zip` attachments, and `network-capture-*.ndjson` at the top level. By default, scans Playwright config `outputDir`, test-results/, then pm-results/.]:path:_files -g "*.json"' \
     '--capture-only[Skip collection matching and tests; capture traffic and save a V3 collection organised by host]' \
     '--output[Output directory for captured collection (default\: pm-results/captured/; used with --capture-only)]:path:_files -g "*.json"' \
-    '--force[Overwrite the output directory if it exists and is not empty (used with --capture-only)]' \
-    '--report-events[Send application test run results to Postman (default\: true)]:boolean' \
-    '--no-report-events[Do not send run results or analytics to Postman]' \
+    '--force[Deprecated\: output directory is always overwritten on re-run (used with --capture-only)]' \
+    '--report-events[Dispatch application test run results to the API Catalog and Application Inventory ingestion pipelines (on by default) (default\: true)]:boolean' \
+    '--no-report-events[Do not dispatch run results to the API Catalog and Application Inventory ingestion pipelines]' \
     '--verbose[Show detailed per-request matching, sandbox errors, and debug information]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -2065,38 +2360,119 @@ _postman_application_setup_capture() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_simulate() {
+_postman_simulation() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_simulate_commands' \
+    '1: :_postman_simulation_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        run) _postman_simulate_run ;;
+        create) _postman_simulation_create ;;
+        list) _postman_simulation_list ;;
+        get) _postman_simulation_get ;;
+        run) _postman_simulation_run ;;
+        push) _postman_simulation_push ;;
+        deploy) _postman_simulation_deploy ;;
+        delete) _postman_simulation_delete ;;
       esac
       ;;
   esac
 }
 
-_postman_simulate_commands() {
+_postman_simulation_commands() {
   local -a sub
   sub=(
-    'run:Start mocks with fault-injection scenarios defined in a .sim.yaml file'
+    'create:Create a simulation that serves several mocks behind one address'
+    'list:List the simulations in your repository or Postman cloud workspace'
+    'get:Show a simulation'\''s details using its .sim.yaml path if it lives in your repository, or its id if it lives in Postman cloud.'
+    'run:Serve a simulation'\''s mocks on one local port, routing each by its routeKey. Pass a .sim.yaml path (local) or a Postman simulation id (fetched and run locally).'
+    'push:Upload a simulation from your repository to Postman cloud (creates it the first time, updates it after). Its member mocks are pushed too.'
+    'deploy:Turn a simulation in Postman cloud into a live mock server others can call over the internet.'
+    'delete:Delete a simulation using its .sim.yaml path if it lives in your repository, or its id if it lives in Postman cloud. Cannot be undone.'
   )
-  _describe -t commands 'simulate command' sub
+  _describe -t commands 'simulation command' sub
+}
+
+_postman_simulation_create() {
+  _arguments \
+    '(-n --name)'{-n,--name}'[Name for the simulation]:name' \
+    '--mock[A mock to include (repeatable). Use a local mock path to build the simulation in your repository, or a Postman mock id to create it in Postman cloud. Set its address with <mockIdOrPath>=<routeKey>. (default\: \[\])]:mockIdOrPath:_files -g "*.json"' \
+    '--routing[How callers reach each mock\: header or path (default path)]:header|path' \
+    '(-o --output)'{-o,--output}'[Where to save the simulation file in your repository, a file or folder (defaults to postman/simulations)]:path:_files -g "*.json"' \
+    '--force[Overwrite the simulation file if it already exists]' \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace to create the simulation in, by id (defaults to the workspace already linked to this project)]:id' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_simulation_list() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace whose simulations to list, by id (defaults to the workspace already linked to this project)]:id' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the list as machine-readable data instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:pathOrDir:_files -g "*.json"'
+}
+
+_postman_simulation_get() {
+  _arguments \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the details as machine-readable data instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:simIdOrPath:'
+}
+
+_postman_simulation_run() {
+  _arguments \
+    '(-e --environment)'{-e,--environment}'[Path to a file of environment variables for the mocks (relative or absolute)]:path:_files -g "*.json"' \
+    '(-g --globals)'{-g,--globals}'[Path to a file of global variables for the mocks (relative or absolute)]:path:_files -g "*.json"' \
+    '(-p --port)'{-p,--port}'[Port to serve on (e.g. 4010), or "auto" for a free one (default 3000)]:port' \
+    '--dataset[Dataset file or folder to load for pm.datasets (repeatable) (default\: \[\])]:pathOrDir:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace for recording start history. Derived from a simulation id or the linked project; needed only for an unlinked .sim.yaml path.]:id' \
+    '--simulation[Simulation id to record start history against for a .sim.yaml path (a local file has only a name). Not needed when running by simulation id, or when the file is linked to a cloud simulation (via workspace push).]:id' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--no-history[Do not record this run in the simulation'\''s start history]' \
+    '--output[Live output format\: auto (default, human-readable logs) or ndjson (one JSON event per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default\: "auto")]:format' \
+    '--proxy[Serve the mocks behind a local HTTP(S) forward proxy instead of one routed port, so a repo under test can point HTTP_PROXY/HTTPS_PROXY at it and reach each mock by hostname without code changes. Requires a simulation.yaml (routing config), not a .sim.yaml.]' \
+    '--proxy-port[Port for the proxy server. Distinct from --port, which is the one-port run'\''s own port. (default\: 7001)]:n' \
+    '--scenario[Scenario each mock serves, sent as both pm-mock-scenario and x-mock-scenario. (default\: "default")]:name' \
+    '--session[Session id to select via the x-mock-session header (default\: a generated id).]:id' \
+    '--log-format[Proxy request log format\: text or json. (default\: "text")]:format' \
+    '--log-body[Also log each response body (truncated). Buffers full responses in memory; meant for temporary debugging, not left on by default.]' \
+    '--doctor[Start the proxy, probe each available HTTP client (fetch/undici/axios/node-fetch) to confirm it honors HTTP_PROXY/HTTPS_PROXY, then exit.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:simIdOrPath:'
+}
+
+_postman_simulation_push() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace to upload to, by id (defaults to the workspace already linked to this project)]:id' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:simPath:'
+}
+
+_postman_simulation_deploy() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace that will own the server, by id (defaults to the workspace already linked to this project)]:id' \
+    '(-n --name)'{-n,--name}'[Name for the mock server (you are asked for one if you skip this)]:name' \
+    '(-s --slug)'{-s,--slug}'[Short label used in the server'\''s web address, e.g. "my-sim" (you are asked for one if you skip this)]:slug' \
+    '--private[Require a Postman API key to reach the server. Public by default.]' \
+    '(-y --yes)'{-y,--yes}'[Use the defaults and skip all questions (public)]' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:simId:'
 }
 
-_postman_simulate_run() {
+_postman_simulation_delete() {
   _arguments \
-    '(-w --workspace)'{-w,--workspace}'[Workspace that owns the run, for recording its simulation start history.]:id' \
-    '--simulation[Simulation id to record start history against (a local .sim.yaml has only a name). Required, with --workspace, to record history.]:id' \
-    '--api-key[Postman API key for recording start history (defaults to your `postman login` session).]:key:_files -g "*.(pem|crt|key)"' \
-    '--no-history[Do not record this run in the simulation'\''s start history.]' \
+    '(-y --yes)'{-y,--yes}'[Delete without asking for confirmation first]' \
+    '--api-key[Postman API key, used with a Postman cloud id (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:filepath:_files -g "*.json"'
+    '*:simIdOrPath:'
 }
 
 _postman_describe() {
@@ -2713,7 +3089,7 @@ _postman_dataset_get() {
 
 _postman_dataset_query() {
   _arguments \
-    '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
+    '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM users LIMIT 10")]:sql' \
     '(-s --source)'{-s,--source}'[Execute directly against a database datasource; without --source, use federated SQLite]:nameOrIdOrSlug' \
     '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
     '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
@@ -2787,14 +3163,14 @@ _postman_dataset_source_list() {
 _postman_dataset_source_add() {
   _arguments \
     '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to; positional target is also accepted for v1.45 compatibility]:datasetPathOrId' \
-    '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
+    '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name when it loads a file or a database --table). Required for every source except a spreadsheet, whose worksheets are each named source_<worksheet>]:name' \
     '--source-id[Override the generated source id (local dataset only)]:uuid' \
-    '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
+    '--format[Use this format instead of extension/type inference; file contents are not sniffed. A spreadsheet (xlsx/xls/ods) is added as one source per worksheet, each named source_<worksheet>]:csv|json|xlsx|xls|ods|jdbc|mysql|postgres|sqlserver' \
     '--type[Source kind; local is inferred from --file, jdbc from --driver-jar]:local|mysql|postgresql|sqlserver|jdbc' \
-    '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
+    '--file[Path to a local CSV/JSON/spreadsheet file (absolute or cwd-relative)]:path:_files -g "*.json"' \
     '--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.]' \
+    '--upload[Cloud dataset only\: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem source read by the local engine. Either way a cloud dataset takes csv/json only — add a spreadsheet to a local .dataset.yaml, where each worksheet becomes its own source.]' \
     '--driver-jar[JDBC driver JAR(s). Repeatable, or pass several after one flag]:path...:_files -g "*.json"' \
     '--driver-class[Driver class. Auto-resolved when the JAR contains exactly one]:fqcn' \
     '--driver-name[Label for this driver type (defaults to the JAR filename)]:label' \
@@ -2813,7 +3189,7 @@ _postman_dataset_source_add() {
     '--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' \
     '--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' \
     '--database[DB database name]:db' \
-    '--table[DB table name (required for sqlserver)]:table' \
+    '--table[DB table to load (required for sqlserver). Leave it out to connect to the whole database; query it with `dataset query -s <source>` or `dataset view create -s <source>`]:table' \
     '--ssh-host[SSH bastion host]:host' \
     '--ssh-port[SSH bastion port]:port' \
     '--ssh-user[SSH bastion user]:user' \
@@ -2845,7 +3221,7 @@ _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 (local dataset only; cloud source formats are immutable)]:csv|json|mysql|postgres|sqlserver' \
+    '--format[Change the format (local dataset only; cloud source formats are immutable). A spreadsheet format is not offered here\: this command changes the format field alone and cannot pin a worksheet, so the source would not compile. Add the workbook with `dataset source add` instead, which makes one worksheet-pinned source per sheet]:csv|json|jdbc|mysql|postgres|sqlserver' \
     '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
     '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
     '--force[With --file, overwrite the copied destination (local dataset only)]' \
@@ -2866,7 +3242,7 @@ _postman_dataset_source_update() {
     '--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' \
     '--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' \
     '--database[Update DB database name]:db' \
-    '--table[Update DB table name]:table' \
+    '--table[Update the DB table to load. A source without a table connects to the whole database; query it with `dataset query -s <source>` or `dataset view create -s <source>`]:table' \
     '--ssh-host[Update SSH bastion host]:host' \
     '--ssh-port[Update SSH bastion port]:port' \
     '--ssh-user[Update SSH bastion user]:user' \
@@ -3023,6 +3399,7 @@ _postman_dependency() {
     args)
       case $words[1] in
         add) _postman_dependency_add ;;
+        get) _postman_dependency_get ;;
         list) _postman_dependency_list ;;
         install) _postman_dependency_install ;;
         update) _postman_dependency_update ;;
@@ -3036,6 +3413,7 @@ _postman_dependency_commands() {
   local -a sub
   sub=(
     'add:Add a Postman collection, environment, or mock as a workspace dependency.'
+    'get:Show a declared workspace dependency from .postman/resources.yaml.'
     'list:List the workspace dependencies declared in .postman/resources.yaml.'
     'install:Materialise the dependencies declared in .postman/resources.yaml (all, or one).'
     'update:Refresh declared dependencies to the latest content from their source (all, or one).'
@@ -3053,6 +3431,14 @@ _postman_dependency_add() {
     '*:nameOrId:'
 }
 
+_postman_dependency_get() {
+  _arguments \
+    '--type[Only match dependencies of this type (collection, environment, or mock).]:type' \
+    '--json[Output the result as JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:nameOrId:'
+}
+
 _postman_dependency_list() {
   _arguments \
     '--type[Only list dependencies of this type (collection, environment, or mock).]:type' \
@@ -3085,6 +3471,52 @@ _postman_dependency_remove() {
     '*:nameOrId:'
 }
 
+_postman_secret() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_secret_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        create) _postman_secret_create ;;
+        list) _postman_secret_list ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_secret_commands() {
+  local -a sub
+  sub=(
+    'create:Create a secret in a team'\''s shared vault.'
+    'list:List the secrets in a workspace'\''s shared vault\: key, secret id, vault id, and allowed domains.'
+  )
+  _describe -t commands 'secret command' sub
+}
+
+_postman_secret_create() {
+  _arguments \
+    '--team-id[Team id (defaults to your authenticated profile'\''s team; must be your own team — the vault rejects any other team id, even one you otherwise have access to)]:id' \
+    '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)]:workspaceId' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '--terminal[Enter one secret value through the terminal instead of the default browser form]' \
+    '--value-stdin[Read the secret value from stdin instead of prompting; implies --terminal]' \
+    '--timeout[Seconds to wait for the browser form (default 300)]:seconds' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:keys...:_files -g "*.json"'
+}
+
+_postman_secret_list() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Postman workspace ID (falls back to .postman/resources.yaml or .postman/config.json)]:workspaceId' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the list as machine-readable JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 # When loaded via fpath + compinit, the file body becomes the function body of
 # `_postman`. In that case `funcstack[1]` is `_postman` and we must actually
 # invoke the completion. When sourced directly, this is a no-op — `_postman`