postman-cli-completion 1.76.0 → 1.77.0

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.76.0)
+# Zsh completion for Postman CLI (postman v1.77.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -163,6 +163,7 @@ _postman_collection() {
         publish) _postman_collection_publish ;;
         generate) _postman_collection_generate ;;
         sync) _postman_collection_sync ;;
+        share) _postman_collection_share ;;
         request) _postman_collection_request ;;
         folder) _postman_collection_folder ;;
         example) _postman_collection_example ;;
@@ -186,6 +187,7 @@ _postman_collection_commands() {
     '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.'
+    'share:Grant a role on a collection to one or more people.'
     '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.'
@@ -329,6 +331,17 @@ _postman_collection_sync_spec() {
     '*:collection:_files -g "*.json"'
 }
 
+_postman_collection_share() {
+  _arguments \
+    '--user[Who to share with. Repeatable, and each value may be a comma-separated list. A value containing @ is treated as an email address, anything else as a Postman user id.]:email|id' \
+    '--role[The role to grant. (default\: "viewer")]:viewer|editor' \
+    '--json[Print the outcome as machine-readable JSON.]' \
+    '--timeout[Milliseconds to wait for Postman. Defaults to 30000.]:ms' \
+    '--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]' \
+    '*:id:'
+}
+
 _postman_collection_request() {
   local context state state_descr line
   typeset -A opt_args
@@ -1046,6 +1059,7 @@ _postman_environment() {
         new) _postman_environment_new ;;
         list) _postman_environment_list ;;
         get) _postman_environment_get ;;
+        share) _postman_environment_share ;;
         delete) _postman_environment_delete ;;
         var) _postman_environment_var ;;
         lint) _postman_environment_lint ;;
@@ -1060,6 +1074,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.'
+    'share:Grant a role on a cloud environment to one or more people.'
     '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.'
@@ -1095,6 +1110,17 @@ _postman_environment_get() {
     '*:environment:_files -g "*.json"'
 }
 
+_postman_environment_share() {
+  _arguments \
+    '--user[Who to share with. Repeatable, and each value may be a comma-separated list. A value containing @ is treated as an email address, anything else as a Postman user id.]:email|id' \
+    '--role[The role to grant. (default\: "viewer")]:viewer|editor' \
+    '--json[Print the outcome as machine-readable JSON.]' \
+    '--timeout[Milliseconds to wait for Postman. Defaults to 30000.]:ms' \
+    '--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]' \
+    '*:environmentId:_files -g "*.json"'
+}
+
 _postman_environment_delete() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Delete without asking for confirmation first]' \
@@ -1473,7 +1499,7 @@ _postman_mock_generate() {
     '--deploy[After generating, upload the mock to Postman cloud and deploy it to a live mock server (private by default). Uses --workspace, else the workspace linked to this project.]' \
     '--public[With --deploy, let anyone with the link reach the server (default\: callers need an API key)]' \
     '(-s --slug)'{-s,--slug}'[With --deploy, the short label used in the server'\''s web address]:slug' \
-    '--json[With --deploy, print the live server details as machine-readable data instead of a summary]' \
+    '--json[Print the result (with --deploy, the live server details) as machine-readable data instead of a summary]' \
     '--api-key[Postman API key to use with --workspace or --deploy (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]' \
@@ -1499,6 +1525,7 @@ _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)"' \
+    '--json[Print the result as machine-readable data]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockPath:_files -g "*.json"'
 }
@@ -1520,7 +1547,7 @@ _postman_mock_deploy() {
 _postman_mock_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]' \
+    '--json[Print the details as machine-readable data instead of a summary]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockIdOrPath:_files -g "*.json"'
 }
@@ -1552,6 +1579,7 @@ _postman_mock_delete() {
   _arguments \
     '(-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)"' \
+    '--json[Print the result as machine-readable data (requires --yes)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockIdOrPath:_files -g "*.json"'
 }
@@ -1577,6 +1605,7 @@ _postman_monitor() {
         metrics) _postman_monitor_metrics ;;
         pause) _postman_monitor_pause ;;
         resume) _postman_monitor_resume ;;
+        share) _postman_monitor_share ;;
       esac
       ;;
   esac
@@ -1585,17 +1614,18 @@ _postman_monitor() {
 _postman_monitor_commands() {
   local -a sub
   sub=(
-    'run:Invoke a monitor run and display results.'
+    'run:Run a monitor now and report the result.'
     'create:Create a collection-based monitor.'
     '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.'
-    'list:List the monitors visible to you.'
-    'get:Show a monitor'\''s configuration.'
+    'jobs:Inspect a monitor'\''s jobs (also called executions) and their per-runner runs.'
+    'runs:Inspect one run of a monitor job\: its requests, assertions and attempts.'
+    'list:List the monitors visible to you, one page at a time.'
+    'get:Show a monitor'\''s configuration and its last run.'
     'metrics:Show per-request latency and outcome history for a monitor.'
     'pause:Pause a monitor, so it stops firing on schedule.'
     'resume:Resume a paused monitor, so it fires on schedule again.'
+    'share:Grant a role on a monitor to one or more people.'
   )
   _describe -t commands 'monitor command' sub
 }
@@ -1603,28 +1633,28 @@ _postman_monitor_commands() {
 _postman_monitor_run() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest 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]' \
+    '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Always exit 0, whatever the run'\''s result or the failure]' \
+    '(-t --timeout)'{-t,--timeout}'[How long to wait for the run to finish, in milliseconds (default\: 900000)]:ms' \
+    '--async[Submit the run and print its job id and Postman URL without waiting for it to finish]' \
+    '--json[Print { state, monitorId, jobId, url, stats } as JSON, and 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' \
+    '(-c --collection)'{-c,--collection}'[Collection to monitor\: its id or uid, from the Postman app or `postman collection list`]:id' \
     '--name[Monitor name (defaults to the linked collection'\''s own name)]:name' \
-    '(-e --environment)'{-e,--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' \
+    '(-e --environment)'{-e,--environment}'[Environment to run the collection with\: its uid, from the Postman app or `postman environment list`]:id' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace to create the monitor in, from `postman workspace list` (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, five fields\: minute hour day-of-month month day-of-week, for example "0 9 * * MON". Leave month as * unless the monitor should run only in certain months; then write the month as a name (jan-dec)]: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' \
-    '--timeout[Request timeout in milliseconds]:ms' \
+    '--retry[Times to retry a failed run\: --retry 2 allows up to 3 attempts]:n' \
+    '--timeout[Per-request timeout the monitor applies when it runs, in milliseconds (this command does not wait for a run; `postman monitor run --timeout` sets how long that waits)]: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]' \
@@ -1636,25 +1666,25 @@ _postman_monitor_create() {
     '--iteration-strategy[How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
     '--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, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print the outcome, the created monitor'\''s id, uid, name and active state, and the job of its first run, as JSON]' \
     '(-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' \
+    '--schedule[New cron expression for the monitor'\''s schedule, five fields\: minute hour day-of-month month day-of-week, for example "0 9 * * MON". Leave month as * unless the monitor should run only in certain months; then write the month as a name (jan-dec)]: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' \
+    '(-e --environment)'{-e,--environment}'[Environment to run the collection with, replacing the current one\: its uid, from `postman environment list`]:id' \
     '--clear-environment[Run the monitored collection with no environment]' \
     '--notification-limit[Consecutive failure notifications to send before muting them]:n' \
-    '--retry[Times to retry a failed run]:n' \
-    '--timeout[Request timeout in milliseconds]:ms' \
+    '--retry[Times to retry a failed run\: --retry 2 allows up to 3 attempts]:n' \
+    '--timeout[Per-request timeout the monitor applies when it runs, in milliseconds (this command does not wait for a run; `postman monitor run --timeout` sets how long that waits)]: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]' \
@@ -1665,16 +1695,16 @@ _postman_monitor_update() {
     '--iteration-count[Number of iterations to run]:n' \
     '--iteration-strategy[How iteration data is consumed, for example round_robin, repeat_last or stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print the outcome and the monitor'\''s id, uid, name and active state as JSON]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
 
 _postman_monitor_delete() {
   _arguments \
-    '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
+    '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt; required when there is no interactive terminal or with --silent]' \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output the outcome, including any failure, as JSON instead of a plain message]' \
+    '--json[Print the outcome (deleted or aborted) and the monitor id as JSON]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
@@ -1699,29 +1729,29 @@ _postman_monitor_jobs() {
 _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.'
+    'list:List a monitor'\''s recent jobs, newest first. A job (also called an execution) is one firing of the monitor, with one run per runner.'
+    'get:Show one job (also called an execution) and the state, runner and duration of each of its runs. A run'\''s duration covers every attempt, including retries.'
   )
   _describe -t commands 'jobs command' sub
 }
 
 _postman_monitor_jobs_list() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--result[Filter by outcome, for example success, failure, error or abort]:value' \
-    '--trigger[Filter by trigger, for example api, schedule, webhook or postman-cli]:value' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--result[Only jobs that finished in this state\: success, failure, error or abort; any other value is rejected before any request]:state' \
+    '--trigger[Only jobs started by this trigger\: api, schedule, webhook or postman-cli; any other value is rejected before any request]: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]' \
+    '--limit[Jobs per page, 1-25 (default\: 25)]:n' \
+    '--cursor[Page number to read, from the "Next page" line or `nextCursor` under --json of a previous listing; pass the same --limit and filters]:page' \
+    '--json[Print { monitorId, jobs, nextCursor } as JSON, each job with its runs]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
 
 _postman_monitor_jobs_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]' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the job as JSON, with each run'\''s state, runner, counts, duration and attempts]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:jobId:'
 }
@@ -1745,17 +1775,17 @@ _postman_monitor_runs() {
 _postman_monitor_runs_commands() {
   local -a sub
   sub=(
-    'get:Report which test assertions ran during one attempt of a run, which failed, and why.'
+    'get:Show one attempt of a run\: each request with its response or error, and its assertions, console lines and exceptions. A retried run has several attempts, numbered from 0; the latest is shown unless --attempt names another. Console, assertion and exception messages are the collection'\''s own output, printed as the run recorded them.'
   )
   _describe -t commands 'runs command' sub
 }
 
 _postman_monitor_runs_get() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--attempt[Which attempt of the run to show, where 0 is the first (default\: the most recent)]:n' \
-    '--failed-only[Show only failed assertions]' \
-    '--json[Output as JSON instead of a table]' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--attempt[Which attempt to show, from 0 for the first (default\: the latest)]:n' \
+    '--failed-only[Show only requests with a failed assertion, an exception or a network error]' \
+    '--json[Print the run as JSON\: its state, attempt, assertion counts and every request with its entries]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:runId:'
 }
@@ -1763,27 +1793,26 @@ _postman_monitor_runs_get() {
 _postman_monitor_list() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest 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' \
-    '(-e --environment)'{-e,--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[Maximum number of monitors to return (Postman caps the page size and rejects a larger value)]: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' \
+    '(-w --workspace)'{-w,--workspace}'[Only monitors in this workspace (ids from `postman workspace list`)]:id' \
+    '(-c --collection)'{-c,--collection}'[Only monitors on this collection\: its id or uid]:id' \
+    '(-e --environment)'{-e,--environment}'[Only monitors on this environment\: its uid]:id' \
+    '--runner[Only monitors on this self-hosted runner id, from `postman runner list` (not a Postman region). Cannot be combined with --workspace, --collection, --environment, --owner or --active]:id' \
+    '--owner[Only monitors created by this user id\: the `owner` field under --json]:id' \
+    '--active[Only active (true) or paused (false) monitors]:true|false' \
+    '--limit[Monitors per page, 1-25]:n' \
+    '--cursor[Page to read\: the cursor from the "Next page" line of a previous listing, or `nextCursor` under --json; pass the same filters and --limit]:token' \
+    '--columns[Comma-separated columns to show. Defaults to Name, ID, State, Health, Schedule, Owner, Collection, dropping Collection, Owner, Schedule in that order when the table is wider than the terminal. Also available\: Environment, Runners, Notifications]:names' \
+    '--no-headers[Omit the header row and its rule]' \
+    '(-f --filter)'{-f,--filter}'[Only monitors whose name contains this text, case-insensitive (applies to the returned page)]:text' \
     '--sort[Sort the returned page by "name" or "active"]:field' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print { monitors, nextCursor } as JSON, every monitor field except lastRun present (null when unset); monitor get carries lastRun]' \
     '(-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, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print the monitor as JSON, every field present (null when unset)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
@@ -1794,8 +1823,8 @@ _postman_monitor_metrics() {
     '--since[Only executions at or after this ISO 8601 date-time (defaults to 7 days ago)]:dateTime' \
     '--until[Only executions at or before this ISO 8601 date-time (defaults to now)]:dateTime' \
     '(-f --filter)'{-f,--filter}'[Show only requests whose name contains this text (case-insensitive)]:text' \
-    '--limit[Maximum number of rows to show\: executions, newest first, under --json, or requests, worst-behaving first, in the table. Applied to the results after they are fetched, so it does not make the command faster]:n' \
-    '--json[Output as JSON instead of a table]' \
+    '--limit[Rows to show, any positive whole number\: the worst-behaving requests in the table, or the newest executions under --json. Applied after the results are fetched]:n' \
+    '--json[Print { monitorId, window, metricsAvailable, executions } as JSON, one entry per request per job per runner]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
@@ -1803,7 +1832,7 @@ _postman_monitor_metrics() {
 _postman_monitor_pause() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print the outcome and the monitor'\''s id, uid, name and active state as JSON]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
 }
@@ -1811,7 +1840,18 @@ _postman_monitor_pause() {
 _postman_monitor_resume() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session, then a guest session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Output as JSON instead of a table]' \
+    '--json[Print the outcome and the monitor'\''s id, uid, name and active state as JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:monitorId:'
+}
+
+_postman_monitor_share() {
+  _arguments \
+    '--user[Who to share with. Repeatable, and each value may be a comma-separated list. A value containing @ is treated as an email address, anything else as a Postman user id.]:email|id' \
+    '--role[The role to grant. (default\: "viewer")]:viewer|editor' \
+    '--json[Print the outcome as machine-readable JSON.]' \
+    '--timeout[Milliseconds to wait for Postman. Defaults to 30000.]:ms' \
+    '--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]' \
     '*:monitorId:'
 }
@@ -1908,7 +1948,7 @@ _postman_runner_start() {
   _arguments \
     '--id[The ID of the runner to execute]:id' \
     '--key[The secret key for the runner]:key:_files -g "*.(pem|crt|key)"' \
-    '--region[Region this runner reports to -- use "eu" for the EU region]:region' \
+    '--region[Data residency of the Postman account the runner belongs to\: "us" (default) or "eu". This is not a monitor runner region]:region' \
     '--proxy[External proxy URL, for example http\://proxy.com or http\://proxy.com\:8080]:url' \
     '--egress-proxy[Enable built-in egress proxy]' \
     '--egress-proxy-authz-url[Custom egress proxy authorization service base URL]:url' \
@@ -1924,15 +1964,15 @@ _postman_runner_start() {
 _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)"' \
-    '(-w --workspace)'{-w,--workspace}'[Filter to runners in this workspace]:id' \
-    '--json[Output the runner list as JSON instead of a table]' \
+    '(-w --workspace)'{-w,--workspace}'[Only runners this workspace can use\: runners scoped to it and runners shared with the whole team]:id' \
+    '--json[Print { runners } as JSON, every field present (null when unset)]' \
     '(-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]' \
+    '--json[Print { regions } as JSON, every field present (null when unset)]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -2261,7 +2301,7 @@ _postman_spec_generate() {
 _postman_spec_generate_commands() {
   local -a sub
   sub=(
-    'collection:Generate a Postman collection from a specification.'
+    'collection:Generate a Postman collection from an OpenAPI or AsyncAPI (Kafka) specification. Only Kafka AsyncAPI 2.x and 3.0 specs are supported\: the spec must declare a kafka or kafka-secure server.'
   )
   _describe -t commands 'generate command' sub
 }
@@ -2269,7 +2309,7 @@ _postman_spec_generate_commands() {
 _postman_spec_generate_collection() {
   _arguments \
     '(-n --name)'{-n,--name}'[Collection name]:name' \
-    '--folder-strategy[Folder strategy\: Paths or Tags (default\: Paths) (default\: "Paths")]:strategy' \
+    '--folder-strategy[Folder strategy\: Paths or Tags (default\: Paths). OpenAPI only (default\: "Paths")]:strategy' \
     '(-w --workspace)'{-w,--workspace}'[Workspace ID (cloud mode)]:id' \
     '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
     '--force[Overwrite the collection if one with this name already exists (local mode)]' \
@@ -2305,8 +2345,8 @@ _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, headers and descriptions that the spec would otherwise drop]' \
-    '--dry-run[Report what sync would change and remove without writing anything]' \
+    '--force[Overwrite hand-written scripts, headers and descriptions that the spec would otherwise drop (OpenAPI), or collection files that could not be read (AsyncAPI)]' \
+    '--dry-run[Report what sync would change and remove without writing anything (OpenAPI only)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:spec:'
 }
@@ -2337,6 +2377,7 @@ _postman_workspace() {
         activity) _postman_workspace_activity ;;
         create) _postman_workspace_create ;;
         delete) _postman_workspace_delete ;;
+        share) _postman_workspace_share ;;
         pull) _postman_workspace_pull ;;
         connect-git) _postman_workspace_connect_git ;;
         disconnect-git) _postman_workspace_disconnect_git ;;
@@ -2357,7 +2398,8 @@ _postman_workspace_commands() {
     'activity:Read a workspace'\''s activity feed.'
     'create:Create a Postman workspace and bind it to this git repository.'
     'delete:Permanently delete a workspace and everything in it. Prompts for confirmation unless --yes is passed.'
-    'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
+    'share:Grant a role on a workspace to one or more people.'
+    'pull:Pull workspace entities from a Postman workspace into the local folder.'
     'connect-git:Connect a Postman workspace to a local git repository.'
     'disconnect-git:Disconnect a Postman workspace from its local git repository.'
     'diff:Preview local-vs-cloud drift before pushing. Read-only\: nothing is created, updated or deleted.'
@@ -2451,6 +2493,17 @@ _postman_workspace_delete() {
     '*:workspaceId:'
 }
 
+_postman_workspace_share() {
+  _arguments \
+    '--user[Who to share with. Repeatable, and each value may be a comma-separated list. A value containing @ is treated as an email address, anything else as a Postman user id.]:email|id' \
+    '--role[The role to grant. (default\: "viewer")]:viewer|editor' \
+    '--json[Print the outcome as machine-readable JSON.]' \
+    '--timeout[Milliseconds to wait for Postman. Defaults to 30000.]:ms' \
+    '--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]' \
+    '*:workspaceId:'
+}
+
 _postman_workspace_pull() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
@@ -2834,7 +2887,6 @@ _postman_init() {
   _arguments \
     '--json[Emit machine-readable output for agents]' \
     '--dry-run[Report what would happen without writing anything]' \
-    '--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' \
     '(-y --yes)'{-y,--yes}'[Accept the default for every question instead of asking or stopping]' \
@@ -3344,7 +3396,7 @@ _postman_simulation_create() {
     '--deploy[After creating, upload the simulation (and its mocks) to Postman cloud and deploy it to a live mock server (private by default).]' \
     '--public[With --deploy, let anyone with the link reach the server (default\: callers need an API key)]' \
     '(-s --slug)'{-s,--slug}'[With --deploy, the short label used in the server'\''s web address]:slug' \
-    '--json[With --deploy, print the live server details as machine-readable data instead of a summary]' \
+    '--json[Print the result (with --deploy, the live server details) as machine-readable data instead of a summary]' \
     '--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]'
 }
@@ -3361,7 +3413,7 @@ _postman_simulation_list() {
 _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]' \
+    '--json[Print the details as machine-readable data instead of a summary]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:simIdOrPath:'
 }
@@ -3393,6 +3445,7 @@ _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)"' \
+    '--json[Print the result as machine-readable data]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:simPath:'
 }
@@ -3442,6 +3495,7 @@ _postman_simulation_delete() {
   _arguments \
     '(-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)"' \
+    '--json[Print the result as machine-readable data (requires --yes)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:simIdOrPath:'
 }

package/package.json

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