postman-cli-completion 1.75.0 → 1.77.0

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.75.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.'
@@ -200,6 +202,7 @@ _postman_collection_new() {
   _arguments \
     '(-w --workspace)'{-w,--workspace}'[Create the collection in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.]:workspaceId' \
     '--force[Rewrite the definition of an existing local collection. Existing request files are left alone.]' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode (--workspace) only.]:text' \
     '--verbose[Verbose output]' \
     '--json[JSON output]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -242,6 +245,7 @@ _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)"' \
+    '(-m --message)'{-m,--message}'[Short note on why, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud collections only.]:text' \
     '--verbose[Verbose output]' \
     '--json[Output the result as JSON]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -327,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
@@ -364,6 +379,7 @@ _postman_collection_request_add() {
     '--folder[Folder within the collection, e.g. "Users/Admin". Defaults to the root.]:id|name|path' \
     '--type[Request type\: http, graphql, grpc, websocket, socketio. (default\: "http")]:type' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:request-name:'
@@ -396,6 +412,7 @@ _postman_collection_request_update() {
     '--scripts[Replace scripts. event is prerequest or test; script is @file, - for stdin, or inline. Repeatable; any request type. (default\: \[\])]:event\:script' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
     '--type[Request type for cloud mode\: http, graphql, grpc, websocket, socketio. (default\: "http")]:type' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:request:'
@@ -407,6 +424,7 @@ _postman_collection_request_rm() {
     '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
     '--type[Request type for cloud mode\: http, graphql, grpc, websocket, socketio. (default\: "http")]:type' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:request:'
@@ -448,6 +466,7 @@ _postman_collection_folder_add() {
     '--collection[Target collection\: name, directory, id, cloud id, or path. Required.]:id|name' \
     '--folder[Parent folder within the collection, e.g. "Users/Admin". Defaults to the root.]:id|name|path' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:folder-name:'
@@ -472,6 +491,7 @@ _postman_collection_folder_update() {
     '--auth[Folder auth\: none, inherit, bearer\:TOKEN, basic\:USER\:PASS, apikey\:KEY\:VALUE\[\:header|query\], oauth2\:TOKEN.]:spec' \
     '--scripts[Replace folder scripts. event is prerequest or test; script is @file, - for stdin, or inline. Repeatable. (default\: \[\])]:event\:script' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:folder:'
@@ -483,6 +503,7 @@ _postman_collection_folder_rm() {
     '--folder[Parent folder to scope the selector, e.g. "Users" (local\: name/path; cloud\: id).]:id|name|path' \
     '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt (required when stdout is not a TTY).]' \
     '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:folder:'
@@ -528,6 +549,7 @@ _postman_collection_example_add() {
     '--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' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:example-name:'
@@ -553,6 +575,7 @@ _postman_collection_example_update() {
     '--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' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:example:'
@@ -565,6 +588,7 @@ _postman_collection_example_rm() {
     '--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' \
+    '(-m --message)'{-m,--message}'[Short note on what changed, like a commit message (max 500 characters). Shown on the workspace activity feed. Cloud mode only.]:text' \
     '--json[JSON output.]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:example:'
@@ -653,8 +677,7 @@ _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 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 or --simulation (e.g. 4010), or "auto" for a free one. Defaults to the configured port. Only valid with --mock or --simulation.]:port' \
+    '--port[Port for the --simulation server (e.g. 4010), or "auto" for a free one. Defaults to the configured port. Only valid with --simulation.]: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' \
     '--simulation[Run the mocks in a simulation for the run, its .sim.yaml path if it lives in your repository (relative or absolute, e.g. ./postman/simulations/checkout.sim.yaml) or its id if it lives in Postman cloud (fetched then run locally). Members share one port and are addressed by routeKey (e.g. http\://localhost\:3000/<routeKey>/path). An id needs `postman login` (or --postman-api-key).]:pathOrId:_files -g "*.json"' \
     '(-w --workspace)'{-w,--workspace}'[Workspace to record the --simulation run'\''s start history against. Defaults to the simulation'\''s own workspace (when run by id) or the linked project'\''s workspace.]:workspaceId' \
@@ -726,7 +749,7 @@ _postman_dataset_query() {
     '(-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)"' \
-    '--json[Output rows as JSON instead of a table]' \
+    '--json[Output rows as JSON instead of a table; a failure prints a JSON error on stdout]' \
     '--debug[Include safe classified dataset diagnostics]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:datasetPathOrId:'
@@ -808,19 +831,20 @@ _postman_dataset_source_add() {
     '--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' \
     '--url-template[JDBC URL with {{placeholders}}, e.g. jdbc\:postgresql\://{{host}}\:{{port}}/{{database}}]:template' \
-    '--var[Value for a {{placeholder}}. Repeatable. Use vault\:<vaultId>/<secretId> for a secret. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:name=value...' \
-    '--prop[Driver connection property. Repeatable. Same vault\: syntax as --var]:name=value...' \
-    '--vars-file[JSON object of --var values; "-" reads stdin. Supports {"$vaultId"\:..,"$secretId"\:..} objects, and keeps secrets out of argv entirely]:path:_files -g "*.json"' \
+    '--var[Value for a {{placeholder}}. Repeatable. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:name=value...' \
+    '--prop[Driver connection property. Repeatable. Same secret syntax as --var]:name=value...' \
+    '--vars-file[JSON object of values; "-" reads stdin. Keys are host, port, user, password, database (mysql/postgresql/sqlserver), or --var names for jdbc, with optional "vars"/"props" objects for template variables / connection properties. Values take the same secret syntax, or {"$vaultId"\:..,"$secretId"\:..} objects, and keep secrets out of argv entirely]:path:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace whose Shared Vault resolves vault\:<KEY> (falls back to .postman/resources.yaml in the current directory)]:workspaceId' \
     '--from-source[Reuse another source'\''s driver JAR, class and URL template]:name' \
     '--java-path[Java runtime to use. Machine-local only - never written to the dataset. Also read from POSTMAN_JDBC_JAVA_PATH]:path:_files -g "*.json"' \
     '--no-test[Skip the pre-write connection test. Note that resolving the driver class still starts a JVM — on a machine with no Java, pass --driver-class (or --from-source) too]' \
     '--ssh-target-host-variable[Template variable holding the tunnelled host (inferred when omitted)]:name' \
     '--ssh-target-port-variable[Template variable holding the tunnelled port (inferred when omitted)]:name' \
     '--json[Emit the result as JSON instead of prose]' \
-    '--host[DB host (mysql/postgresql/sqlserver)]:host' \
+    '--host[DB host (mysql/postgresql/sqlserver). Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below.]:host' \
     '--port[DB port (defaults to 1433 for sqlserver)]:port' \
-    '--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' \
+    '--user[DB user. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:user' \
+    '--password[DB password. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:password' \
     '--database[DB database name]:db' \
     '--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' \
@@ -862,18 +886,19 @@ _postman_dataset_source_update() {
     '--driver-class[Replace the JDBC driver class]:fqcn' \
     '--driver-name[Rename the JDBC driver type label]:label' \
     '--url-template[Replace the JDBC URL template]:template' \
-    '--var[Set a JDBC template variable. Merges onto the existing values. Use vault\:<vaultId>/<secretId> for a secret. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:name=value...' \
-    '--prop[Set a JDBC connection property. Merges, same vault\: syntax]:name=value...' \
+    '--var[Set a JDBC template variable. Merges onto the existing values. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:name=value...' \
+    '--prop[Set a JDBC connection property. Merges, same secret syntax]:name=value...' \
     '--unset-var[Remove a JDBC template variable. Merging alone can never remove a key]:name...' \
     '--unset-prop[Remove a JDBC connection property]:name...' \
-    '--vars-file[JSON object of --var values; "-" reads stdin]:path:_files -g "*.json"' \
+    '--vars-file[JSON object of values to merge; "-" reads stdin. Keys are host, port, user, password, database (mysql/postgresql/sqlserver), or --var names for jdbc, with optional "vars"/"props" objects. Values take the same secret syntax]:path:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace whose Shared Vault resolves vault\:<KEY> (falls back to .postman/resources.yaml in the current directory)]:workspaceId' \
     '--ssh-target-host-variable[Template variable holding the tunnelled host (JDBC)]:name' \
     '--ssh-target-port-variable[Template variable holding the tunnelled port (JDBC)]:name' \
     '--java-path[Java runtime for JDBC operations. Machine-local only]:path:_files -g "*.json"' \
-    '--host[Update DB host (mysql/postgresql/sqlserver)]:host' \
+    '--host[Update DB host (mysql/postgresql/sqlserver). Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below.]:host' \
     '--port[Update DB port]:port' \
-    '--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' \
+    '--user[Update DB user. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:user' \
+    '--password[Update DB password. Accepts a secret reference\: vault\:<KEY> (preferred), vault\:<vaultId>/<secretId>, or env\:<NAME> — see "Secrets" below. 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).]:password' \
     '--database[Update DB database name]:db' \
     '--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' \
@@ -1034,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 ;;
@@ -1048,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.'
@@ -1083,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]' \
@@ -1437,7 +1475,7 @@ _postman_mock() {
 _postman_mock_commands() {
   local -a sub
   sub=(
-    '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.'
+    '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. Add --deploy to also make it a live mock server.'
     '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.'
@@ -1457,8 +1495,12 @@ _postman_mock_generate() {
     '--stateful[Generate pm.state-backed CRUD handlers (create/read/list/update/delete) instead of static example responses. Endpoints that are not CRUD-shaped stay static. Applies to collection or spec sources.]' \
     '--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)"' \
+    '(-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, except with --deploy, where it only picks the workspace.]:id' \
+    '--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[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]' \
     '*:sourcePath:'
@@ -1483,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"'
 }
@@ -1496,6 +1539,7 @@ _postman_mock_deploy() {
     '--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)"' \
+    '--json[Print the live server details as machine-readable data instead of a summary (asks no questions)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockId:_files -g "*.json"'
 }
@@ -1503,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"'
 }
@@ -1535,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"'
 }
@@ -1560,6 +1605,7 @@ _postman_monitor() {
         metrics) _postman_monitor_metrics ;;
         pause) _postman_monitor_pause ;;
         resume) _postman_monitor_resume ;;
+        share) _postman_monitor_share ;;
       esac
       ;;
   esac
@@ -1568,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
 }
@@ -1586,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]' \
@@ -1619,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]' \
@@ -1648,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:'
 }
@@ -1682,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:'
 }
@@ -1728,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:'
 }
@@ -1746,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:'
 }
@@ -1777,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:'
 }
@@ -1786,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:'
 }
@@ -1794,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:'
 }
@@ -1891,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' \
@@ -1907,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]'
 }
 
@@ -2244,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
 }
@@ -2252,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)]' \
@@ -2288,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:'
 }
@@ -2320,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 ;;
@@ -2340,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.'
@@ -2434,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]' \
@@ -2507,7 +2577,6 @@ _postman_context_graph_ask() {
     '--api-key[Postman API key (falls back to POSTMAN_API_KEY, then a `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output the ask record as JSON]' \
     '--no-include-answer[Do not ask the service to include the answer inline]' \
-    '--max-steps[Cap the reasoning steps the service may take (its default applies when omitted)]:count' \
     '--interval[With --wait, seconds between polls (default\: 2)]:seconds' \
     '--timeout[With --wait, seconds to wait before giving up (default\: 300)]:seconds' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -2818,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]' \
@@ -3264,6 +3332,7 @@ _postman_secret_create() {
     '--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' \
+    '--json[Print the created secrets as machine-readable JSON (never the values)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:keys...:_files -g "*.json"'
 }
@@ -3303,7 +3372,7 @@ _postman_simulation() {
 _postman_simulation_commands() {
   local -a sub
   sub=(
-    'create:Create a simulation that serves several mocks behind one address'
+    'create:Create a simulation that serves several mocks behind one address. Add --deploy to also make it a live mock server.'
     '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).'
@@ -3323,7 +3392,11 @@ _postman_simulation_create() {
     '--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' \
+    '(-w --workspace)'{-w,--workspace}'[Postman cloud workspace to create the simulation in (or deploy it to, with --deploy), by id (defaults to the workspace already linked to this project)]:id' \
+    '--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[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]'
 }
@@ -3340,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:'
 }
@@ -3357,7 +3430,7 @@ _postman_simulation_run() {
     '--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' \
     '--verbose[Show request and response headers and bodies for each request. By default each request prints one line, plus any applied scenario or error.]' \
-    '--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[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. Each mock is reached on the hostnames its `origin\:` declares; a request to any other host reaches the real host unchanged.]' \
     '--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' \
@@ -3372,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:'
 }
@@ -3381,9 +3455,11 @@ _postman_simulation_deploy() {
     '(-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)]' \
+    '--public[Let anyone with the link reach the server. Private by default (callers must send a Postman API key).]' \
+    '--private[Require a Postman API key to reach the server (the default; kept for compatibility).]' \
+    '(-y --yes)'{-y,--yes}'[Use the defaults and skip all questions (private)]' \
     '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the live server details as machine-readable data instead of a summary (asks no questions)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:simId:'
 }
@@ -3419,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:'
 }