postman-cli-completion 1.57.0 → 1.58.0

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.57.0)
+# Zsh completion for Postman CLI (postman v1.58.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -24,6 +24,7 @@ _postman() {
         signup) _postman_signup ;;
         logout) _postman_logout ;;
         init) _postman_init ;;
+        whoami) _postman_whoami ;;
         skills) _postman_skills ;;
         collection) _postman_collection ;;
         environment) _postman_environment ;;
@@ -58,14 +59,15 @@ _postman_commands() {
     'signup:Sign up to keep the work you created as a guest (claims your guest workspace). By default prints a single-use sign-up URL to open in a browser; --browser signs up in a browser and signs this CLI in.'
     'logout:Delete the stored Postman API key.'
     'init:Set up Postman artifacts and agent instructions in a repository.'
+    'whoami:Show the Postman account or guest session this CLI session is using.'
     '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.'
     'api:Publish and test your APIs directly from the command line'
-    'runner:Run runners on your own environments for monitoring your APIs'
+    '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'
-    'monitor:Invoke a monitor run and display results'
+    'monitor:Run and manage Postman monitors.'
     'workspace:Manage workspace resources.'
     'ws:Alias for workspace'
     'performance:Manage performance tests on your collections.'
@@ -73,7 +75,7 @@ _postman_commands() {
     'fl:Alias for flows'
     'request:Send HTTP requests from the command line with full Postman capabilities including authentication, environment variables, assertions, retries, and detailed output control.'
     'sdk:Generate and manage your SDKs directly from the command line.'
-    'mock:Run and manage Postman mocks, locally and in the cloud.'
+    '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.'
@@ -122,6 +124,12 @@ _postman_init() {
     '*:path:_files -g "*.json"'
 }
 
+_postman_whoami() {
+  _arguments \
+    '--json[Print current identity as machine-readable JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_skills() {
   local context state state_descr line
   typeset -A opt_args
@@ -256,9 +264,9 @@ _postman_collection_run() {
     '--cookie-jar[Specify the path to a custom cookie jar (serialized tough-cookie JSON)]:path:_files -g "*.json"' \
     '--export-cookie-jar[Exports the cookie jar to a file after completing the run]:path:_files -g "*.json"' \
     '--verbose[Show detailed information of collection run and each request sent]' \
-    '--mock[Start a mock server from manifest (.json, .yaml or .yml) file]:path:_files -g "*.json"' \
-    '--port[Port for the --mock server; pass "auto" for an OS-assigned ephemeral port (default\: configured port, falls back to an ephemeral one if busy). Only valid with --mock.]:port' \
-    '--use-mock[Redirect requests for a URL or {{variable}} to a mock during the run. Format\: "<url> mock|mock-server\:<path|id> \[scenario\]". Repeat the flag to redirect multiple URLs (one --use-mock per mock). Use "mock\:<path>" for a local mock manifest (.json/.yaml/.yml), "mock\:<id>" for a local mock by id (fetched from the cloud then run locally), or "mock-server\:<id>" to redirect to a deployed mock server'\''s URL. Id-based references require `postman login` (or --postman-api-key). The optional third field selects a scenario (defaults to "default"). (default\: \[\])]:mapping' \
+    '--mock[Start a mock server for the run, its path if it lives in your repository (relative or absolute, e.g. ./postman/mocks/orders) or its id if it lives in Postman cloud (fetched then run locally). An id needs `postman login` (or --postman-api-key).]:pathOrId:_files -g "*.json"' \
+    '--port[Port for the --mock server (e.g. 4010), or "auto" for a free one. Defaults to the mock'\''s configured port. Only valid with --mock.]:port' \
+    '--use-mock[Redirect requests for a URL or {{variable}} to a mock during the run. Format\: "<url> mock|mock-server\:<path|id> \[scenario\]". Repeat the flag to redirect several URLs (one --use-mock each). Use "mock\:<path>" for a mock in your repository (path relative or absolute, e.g. ./postman/mocks/orders), "mock\:<id>" for a mock in Postman cloud (fetched then run locally), or "mock-server\:<id>" to send requests to a deployed mock server. An id needs `postman login` (or --postman-api-key). The optional third field picks a scenario (defaults to "default"). (default\: \[\])]:mapping' \
     '--simulate[Start mock servers with fault-injection scenarios from a .sim.yaml file]:path:_files -g "*.(sim.yaml|yaml|yml)"' \
     '--report-events[Upload results for git-native v3 collection runs. Analytics are sent by default]' \
     '--no-report-events[Do not send analytics to Postman]' \
@@ -368,6 +376,7 @@ _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"'
 }
@@ -479,6 +488,8 @@ _postman_runner() {
     args)
       case $words[1] in
         start) _postman_runner_start ;;
+        list) _postman_runner_list ;;
+        regions) _postman_runner_regions ;;
       esac
       ;;
   esac
@@ -488,6 +499,8 @@ _postman_runner_commands() {
   local -a sub
   sub=(
     'start:Start a runner'
+    'list:List the team'\''s registered self-hosted runners'
+    'regions:List the region and private-runner values valid for monitor create/update --runner, including a static IP where configured'
   )
   _describe -t commands 'runner command' sub
 }
@@ -508,6 +521,20 @@ _postman_runner_start() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_runner_list() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output the runner list as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_runner_regions() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output the region list as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_spec() {
   local context state state_descr line
   typeset -A opt_args
@@ -522,6 +549,8 @@ _postman_spec() {
         ai-readiness) _postman_spec_ai_readiness ;;
         list) _postman_spec_list ;;
         get) _postman_spec_get ;;
+        file) _postman_spec_file ;;
+        create) _postman_spec_create ;;
       esac
       ;;
   esac
@@ -534,6 +563,8 @@ _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).'
+    'create:Create a new spec in a workspace, or (with path) scaffold a local spec file.'
   )
   _describe -t commands 'spec command' sub
 }
@@ -574,6 +605,71 @@ _postman_spec_get() {
     '*:spec...:'
 }
 
+_postman_spec_file() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_spec_file_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        add) _postman_spec_file_add ;;
+        update) _postman_spec_file_update ;;
+        rm) _postman_spec_file_rm ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_spec_file_commands() {
+  local -a sub
+  sub=(
+    'add:Add a new file to a spec.'
+    'update:Update an existing file in a spec.'
+    'rm:Remove a file from a spec.'
+  )
+  _describe -t commands 'file command' sub
+}
+
+_postman_spec_file_add() {
+  _arguments \
+    '(-c --content)'{-c,--content}'[File content (reads from stdin if omitted)]:content' \
+    '--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_update() {
+  _arguments \
+    '(-c --content)'{-c,--content}'[New file content (reads from stdin if omitted)]:content' \
+    '--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_rm() {
+  _arguments \
+    '(-y --yes)'{-y,--yes}'[Skip confirmation prompt]' \
+    '--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_create() {
+  _arguments \
+    '(-n --name)'{-n,--name}'[Specification name / title]:name' \
+    '(-t --type)'{-t,--type}'[Spec type\: openapi, asyncapi, graphql, protobuf, smithy (default\: openapi) (default\: "openapi")]:type' \
+    '--spec-version[Spec version (e.g. 3.1 for openapi, 3 for protobuf)]:ver' \
+    '(-f --format)'{-f,--format}'[File format\: yaml or json (openapi/asyncapi only, default\: yaml) (default\: "yaml")]:fmt' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID (cloud create, defaults to .postman/resources.yaml)]:id' \
+    '--force[Overwrite an existing local file]' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:path:_files -g "*.json"'
+}
+
 _postman_monitor() {
   local context state state_descr line
   typeset -A opt_args
@@ -585,6 +681,15 @@ _postman_monitor() {
     args)
       case $words[1] in
         run) _postman_monitor_run ;;
+        create) _postman_monitor_create ;;
+        update) _postman_monitor_update ;;
+        delete) _postman_monitor_delete ;;
+        jobs) _postman_monitor_jobs ;;
+        runs) _postman_monitor_runs ;;
+        list) _postman_monitor_list ;;
+        get) _postman_monitor_get ;;
+        pause) _postman_monitor_pause ;;
+        resume) _postman_monitor_resume ;;
       esac
       ;;
   esac
@@ -594,14 +699,215 @@ _postman_monitor_commands() {
   local -a sub
   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.'
+    '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.'
+    'list:List the monitors visible to you.'
+    'get:Show a monitor'\''s configuration.'
+    'pause:Pause a monitor, so it stops firing on schedule.'
+    'resume:Resume a paused monitor, so it fires on schedule again.'
   )
   _describe -t commands 'monitor command' sub
 }
 
 _postman_monitor_run() {
   _arguments \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Specify whether or not to override the default exit code for the current run]' \
     '(-t --timeout)'{-t,--timeout}'[Maximum wait time for run completion in milliseconds (default\: 15 minutes) (default\: 900000)]:ms' \
+    '--async[Submit the run and return immediately with its job id and Postman URL, without waiting for completion]' \
+    '--json[Output the run'\''s verdict as JSON instead of a table, printing nothing else]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_create() {
+  _arguments \
+    '(-c --collection)'{-c,--collection}'[Collection to monitor -- accepts the id shown in the Postman app, prefixed or bare]:id' \
+    '--name[Monitor name (defaults to the linked collection'\''s own name)]:name' \
+    '--environment[Environment to run the monitored collection with]:id' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace to create the monitor in (defaults to the workspace named in the local .postman/resources.yaml manifest; required if neither is available)]:id' \
+    '--schedule[Cron expression for the monitor'\''s schedule]:cron' \
+    '--timezone[Time zone for --schedule, e.g. 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' \
+    '--notify-email[Email to notify on a run failure or error (repeatable) (default\: \[\])]:email' \
+    '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
+    '--retry[Retries on a failed run (service caps this at 2)]:n' \
+    '--timeout[Request timeout in milliseconds]:ms' \
+    '--delay[Delay between requests in milliseconds]:ms' \
+    '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
+    '--insecure[Skip TLS certificate verification for the monitored target]' \
+    '--follow-redirects[Follow HTTP redirects during the run]' \
+    '--block-redirects[Do not follow HTTP redirects during the run]' \
+    '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
+    '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
+    '--iteration-count[Number of iterations to run]:n' \
+    '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
+    '--no-run-now[Do not trigger an immediate run after creating the monitor]' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then 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]'
+}
+
+_postman_monitor_update() {
+  _arguments \
+    '--name[New monitor name]:name' \
+    '--schedule[New cron expression for the monitor'\''s schedule]:cron' \
+    '--timezone[Time zone for --schedule, e.g. 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' \
+    '--notify-email[Email to notify on a run failure or error (repeatable; replaces the current list) (default\: \[\])]:email' \
+    '--clear-notifications[Remove every notification recipient]' \
+    '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
+    '--retry[Retries on a failed run (service caps this at 2)]:n' \
+    '--timeout[Request timeout in milliseconds]:ms' \
+    '--delay[Delay between requests in milliseconds]:ms' \
+    '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
+    '--insecure[Skip TLS certificate verification for the monitored target]' \
+    '--follow-redirects[Follow HTTP redirects during the run]' \
+    '--block-redirects[Do not follow HTTP redirects during the run]' \
+    '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
+    '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
+    '--iteration-count[Number of iterations to run]:n' \
+    '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then 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]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_delete() {
+  _arguments \
+    '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output the outcome, including any failure, as JSON instead of a plain message]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_jobs() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_monitor_jobs_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        list) _postman_monitor_jobs_list ;;
+        get) _postman_monitor_jobs_get ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_monitor_jobs_commands() {
+  local -a sub
+  sub=(
+    'list:List a monitor'\''s recent jobs.'
+    'get:Report one job'\''s terminal state and its per-region run outcomes.'
+  )
+  _describe -t commands 'jobs command' sub
+}
+
+_postman_monitor_jobs_list() {
+  _arguments \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--result[Filter by outcome, e.g. success, failure, error, abort (server-validated, not a fixed list)]:value' \
+    '--trigger[Filter by trigger, e.g. api, schedule, webhook, postman-cli (server-validated, not a fixed list)]:value' \
+    '--since[Only jobs that finished at or after this ISO 8601 date-time]:dateTime' \
+    '--limit[Maximum number of jobs to return]:n' \
+    '--cursor[Opaque pagination cursor]:token' \
+    '--json[Output as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_jobs_get() {
+  _arguments \
+    '--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]' \
+    '*:jobId:'
+}
+
+_postman_monitor_runs() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_monitor_runs_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        get) _postman_monitor_runs_get ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_monitor_runs_commands() {
+  local -a sub
+  sub=(
+    'get:Report which test assertions ran during one attempt of a run, which failed, and why.'
+  )
+  _describe -t commands 'runs command' sub
+}
+
+_postman_monitor_runs_get() {
+  _arguments \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--attempt[Which attempt of the run to show, counting from 0 (default\: the latest)]:n' \
+    '--failed-only[Show only failed assertions]' \
+    '--json[Output as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:runId:'
+}
+
+_postman_monitor_list() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-w --workspace)'{-w,--workspace}'[Filter to monitors in this workspace]:id' \
+    '(-c --collection)'{-c,--collection}'[Filter to monitors on this collection]:id' \
+    '--environment[Filter to monitors on this environment]:id' \
+    '--runner[Filter to a Self-Hosted Runner ID (not a Postman Region). Cannot be combined with --workspace, --collection, --environment, --owner, --team or --active.]:id' \
+    '--owner[Filter to monitors created by this user id (shown in the Owner column)]:id' \
+    '--team[Filter to monitors owned by your own team]' \
+    '--active[Filter by active state]:true|false' \
+    '--limit[Max monitors to return. The service caps page size and rejects a value above it with its own error.]:n' \
+    '--offset[Not supported\: the service accepts this parameter and silently ignores it. Refused locally. Use --cursor instead.]:n' \
+    '--cursor[Pagination cursor from a previous page'\''s response.]:token' \
+    '--columns[Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available\: State, Notifications, Environment, Runners.]:names' \
+    '--no-headers[Omit the header row]' \
+    '(-f --filter)'{-f,--filter}'[Show only monitors whose name contains this text (applies to the returned page, case-insensitive)]:text' \
+    '--sort[Sort the returned page by "name" or "active"]:field' \
+    '--json[Output as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_monitor_get() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then 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]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_pause() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then 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]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_resume() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then 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]' \
     '*:monitorId:'
 }
@@ -1103,6 +1409,7 @@ _postman_mock() {
       case $words[1] in
         generate) _postman_mock_generate ;;
         run) _postman_mock_run ;;
+        push) _postman_mock_push ;;
         deploy) _postman_mock_deploy ;;
         get) _postman_mock_get ;;
         list) _postman_mock_list ;;
@@ -1116,26 +1423,27 @@ _postman_mock() {
 _postman_mock_commands() {
   local -a sub
   sub=(
-    'generate:Generate a runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample shopping-cart mock (POST /cart/items, GET /cart, POST /checkout). Writes a local mock by default, or a cloud mock with --workspace.'
-    'run:Start a local mock server from a cloud mock id (fetched and run locally), a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
-    'deploy:Deploy a cloud mock into a mock server.'
-    'get:Show a mock'\''s details\: a cloud mock by id, or a local mock by path.'
-    'list:List a workspace'\''s cloud mocks, or (with a path) local mocks under a directory.'
-    'log:Browse a deployed mock server'\''s request/response logs by its id (see `mock get`).'
-    'delete:Permanently remove a mock\: a cloud mock by id, or a local mock artifact by path.'
+    'generate:Generate a mock from a Postman collection or an OpenAPI file, or from a built-in sample shopping-cart mock (POST /cart/items, GET /cart, POST /checkout). Writes a local mock by default, or a cloud mock with --workspace.'
+    'run:Start a mock using its path if it lives in your repository, or its id if it lives in Postman cloud (fetched and run locally).'
+    'push:Upload a mock from your repository to Postman cloud (creates it the first time, updates it after).'
+    'deploy:Turn a mock in Postman cloud into a live mock server others can call over the internet.'
+    'get:Show a mock'\''s details using its path if it lives in your repository, or its id if it lives in Postman cloud.'
+    'list:List the mocks in your Postman cloud workspace, or — with a folder path — the mocks in that folder in your repository.'
+    'log:Show the requests a live mock server has received and the responses it sent, using its id.'
+    'delete:Delete a mock using its path if it lives in your repository, or its id if it lives in Postman cloud. Cannot be undone.'
   )
   _describe -t commands 'mock command' sub
 }
 
 _postman_mock_generate() {
   _arguments \
-    '(-o --output)'{-o,--output}'[Output directory for the mock (default\: postman/mocks/<slug>)]:dir:_files -g "*.json"' \
-    '(-n --name)'{-n,--name}'[Display name for the generated mock. Optional with a source (derived from it); required when generating without a source.]:name' \
-    '--port[Port the mock server should listen on (default\: 4500)]:port' \
-    '--force[Overwrite the config.yaml/default.js in the output directory if it already exists]' \
-    '(-u --update)'{-u,--update}'[Update an existing mock in place from the source\: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port. Cannot be combined with --output.]:mockPath:_files -g "*.json"' \
-    '(-w --workspace)'{-w,--workspace}'[Create a cloud mock in this Postman workspace instead of a local mock. Cannot be combined with --output/--force/--update.]:id' \
-    '--api-key[Postman API key for --workspace (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-o --output)'{-o,--output}'[Folder to save the mock in. Relative or absolute, e.g. ./postman/mocks/orders. Defaults to postman/mocks/<name>.]:dir:_files -g "*.json"' \
+    '(-n --name)'{-n,--name}'[Name for the mock. Taken from the source when you provide one; required for the sample.]:name' \
+    '--port[Port the mock runs on (e.g. 4010) (default\: 4500)]:port' \
+    '--force[Overwrite the mock'\''s files if the target folder already has one]' \
+    '(-u --update)'{-u,--update}'[Update an existing mock from the source instead of creating a new one. Path to the mock, relative or absolute, e.g. ./postman/mocks/orders. Cannot be used with --output.]:mockPath:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Save the mock to this Postman cloud workspace (by id) instead of your repository. Cannot be used with --output, --force, or --update.]:id' \
+    '--api-key[Postman API key to use with --workspace (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Always exit with code 0, even on failure]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:sourcePath:'
@@ -1143,62 +1451,70 @@ _postman_mock_generate() {
 
 _postman_mock_run() {
   _arguments \
-    '(-e --environment)'{-e,--environment}'[Path to an environment file (JSON or YAML) for pm.environment]:path:_files -g "*.json"' \
-    '(-g --globals)'{-g,--globals}'[Path to a globals file (JSON or YAML) for pm.globals]:path:_files -g "*.json"' \
-    '(-p --port)'{-p,--port}'[Mock server port, or "auto" for an ephemeral one (default\: configured port, falls back to an ephemeral one if busy).]:port' \
-    '--api-key[Postman API key for cloud mock ids (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-e --environment)'{-e,--environment}'[Path to a file of environment variables for the mock. Relative or absolute, e.g. ./postman/environments/dev.json]:path:_files -g "*.json"' \
+    '(-g --globals)'{-g,--globals}'[Path to a file of global variables for the mock. Relative or absolute, e.g. ./globals.json]:path:_files -g "*.json"' \
+    '(-p --port)'{-p,--port}'[Port to run on (e.g. 4010), or "auto" for a free one. Defaults to the mock'\''s configured port.]:port' \
+    '--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]' \
     '*:mockIdOrPath:_files -g "*.json"'
 }
 
+_postman_mock_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]' \
+    '*:mockPath:_files -g "*.json"'
+}
+
 _postman_mock_deploy() {
   _arguments \
-    '(-w --workspace)'{-w,--workspace}'[Workspace that will own the mock server (defaults to the workspace linked in .postman/resources.yaml)]:id' \
-    '(-n --name)'{-n,--name}'[Display name for the mock server (prompts when omitted)]:name' \
-    '(-s --slug)'{-s,--slug}'[Slug for the deploy URL (prompts when omitted)]:slug' \
-    '--public[Deploy as a public mock (default is private; requires an x-api-key header)]' \
-    '--auto-deploy[Re-deploy the mock automatically whenever it changes (default off)]' \
-    '(-y --yes)'{-y,--yes}'[Accept defaults and skip all prompts (private, no auto-deploy)]' \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-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-mock" (you are asked for one if you skip this)]:slug' \
+    '--public[Let anyone with the link reach the server. Private by default (callers must send a Postman API key).]' \
+    '--auto-deploy[Update the live server automatically whenever the mock changes (off by default)]' \
+    '(-y --yes)'{-y,--yes}'[Use the defaults and skip all questions (private, no auto-deploy)]' \
+    '--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]' \
     '*:mockId:_files -g "*.json"'
 }
 
 _postman_mock_get() {
   _arguments \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output the mock details as JSON instead of a table]' \
+    '--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]' \
     '*:mockIdOrPath:_files -g "*.json"'
 }
 
 _postman_mock_list() {
   _arguments \
-    '(-w --workspace)'{-w,--workspace}'[Workspace whose cloud mocks to list (defaults to the workspace linked in .postman/resources.yaml)]:id' \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output the mock list as JSON instead of a table]' \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace whose mocks 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_mock_log() {
   _arguments \
-    '--limit[Maximum number of log entries to show (default 50 for --json/non-interactive output)]:n' \
-    '--method[Filter by HTTP method (e.g. GET, POST)]:method' \
-    '--status[Filter by response status (e.g. 404 or 5xx)]:code|range' \
-    '--path[Filter by request path (supports * and ? wildcards)]:pattern' \
-    '--since[Show logs from this long ago onward (e.g. 2h = the last 2 hours)]:duration' \
-    '--until[Stop this long ago (e.g. 30m = exclude the most recent 30 minutes)]:duration' \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output logs as JSON instead of the interactive pager]' \
+    '--limit[Most entries to show (defaults to 50 when printing machine-readable output)]:n' \
+    '--method[Show only requests of this type (e.g. GET, POST)]:method' \
+    '--status[Show only these response codes (e.g. 404, or 5xx for any 500-series)]:code|range' \
+    '--path[Show only requests to matching addresses (use * and ? as wildcards, e.g. /users/*)]:pattern' \
+    '--since[Show entries from this long ago until now (e.g. 2h = the last 2 hours)]:duration' \
+    '--until[Hide entries newer than this (e.g. 30m = skip the most recent 30 minutes)]:duration' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print entries as machine-readable data instead of the scrollable view]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockServerId:_files -g "*.json"'
 }
 
 _postman_mock_delete() {
   _arguments \
-    '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
-    '--api-key[Postman API key for cloud mock ids (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-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]' \
     '*:mockIdOrPath:_files -g "*.json"'
 }
@@ -2143,6 +2459,9 @@ _postman_dependency() {
     args)
       case $words[1] in
         add) _postman_dependency_add ;;
+        list) _postman_dependency_list ;;
+        install) _postman_dependency_install ;;
+        update) _postman_dependency_update ;;
       esac
       ;;
   esac
@@ -2152,6 +2471,9 @@ _postman_dependency_commands() {
   local -a sub
   sub=(
     'add:Add a Postman collection, environment, or mock as a workspace dependency.'
+    '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).'
   )
   _describe -t commands 'dependency command' sub
 }
@@ -2165,6 +2487,29 @@ _postman_dependency_add() {
     '*:nameOrId:'
 }
 
+_postman_dependency_list() {
+  _arguments \
+    '--type[Only list dependencies of this type (collection, environment, or mock).]:type' \
+    '--json[Output the result as JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
+_postman_dependency_install() {
+  _arguments \
+    '--type[Only install 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_update() {
+  _arguments \
+    '--type[Only update dependencies of this type (collection, environment, or mock).]:type' \
+    '--json[Output the result as JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:nameOrId:'
+}
+
 # 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`

package/package.json

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