postman-cli-completion 1.59.0 → 1.62.0

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.59.0)
+# Zsh completion for Postman CLI (postman v1.62.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -25,6 +25,7 @@ _postman() {
         logout) _postman_logout ;;
         init) _postman_init ;;
         whoami) _postman_whoami ;;
+        feedback) _postman_feedback ;;
         update) _postman_update ;;
         skills) _postman_skills ;;
         collection) _postman_collection ;;
@@ -35,6 +36,7 @@ _postman() {
         spec) _postman_spec ;;
         monitor) _postman_monitor ;;
         workspace|ws) _postman_workspace ;;
+        team) _postman_team ;;
         performance) _postman_performance ;;
         flows|fl) _postman_flows ;;
         request) _postman_request ;;
@@ -42,7 +44,7 @@ _postman() {
         mock) _postman_mock ;;
         application|app) _postman_application ;;
         simulate) _postman_simulate ;;
-        context) _postman_context ;;
+        describe) _postman_describe ;;
         context-graph) _postman_context_graph ;;
         search) _postman_search ;;
         webhook) _postman_webhook ;;
@@ -61,17 +63,19 @@ _postman_commands() {
     'logout:Delete the stored Postman API key.'
     'init:Set up Postman artifacts and agent instructions in a repository.'
     'whoami:Show the Postman account or guest session this CLI session is using.'
+    'feedback:Submit feedback about CLI usability, gaps, and improvement suggestions.'
     'update:Update Postman CLI using the original installation method.'
     'skills:Check and update the agent skills in this repository.'
     'collection:Run and test your Postman collections directly from the command line.'
     'environment:Work with local Postman environments from the command line. Also read cloud environments by ID.'
     'globals:Work with local Postman globals from the command line.'
     'api:Publish and test your APIs directly from the command line'
-    'runner:Where your monitors execute\: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team'
+    'runner:Where your monitors execute\: run and inspect your own self-hosted runners, and list the Postman-operated regions available to your team.'
     'spec:Lint and validate Specifications from the command line'
     'monitor:Run and manage Postman monitors.'
     'workspace:Manage workspace resources.'
     'ws:Alias for workspace'
+    'team:Work with the teams inside your organisation.'
     'performance:Manage performance tests on your collections.'
     'flows:Manage and interact with flows.'
     'fl:Alias for flows'
@@ -81,7 +85,7 @@ _postman_commands() {
     'application:Application-level commands\: initialise config and run tests.'
     'app:Alias for application'
     'simulate:Start mock servers with simulated failure scenarios.'
-    'context:\[Beta\] Get API context for AI coding agents directly from the command line.'
+    'describe:\[Beta\] Get API context for AI coding agents directly from the command line.'
     'context-graph:Ask natural-language questions about your team'\''s Context Graph.'
     'search:Search for Postman element types (requests, collections, workspaces, and more).'
     'webhook:Create and manage Postman webhooks.'
@@ -102,9 +106,7 @@ _postman_login() {
 
 _postman_signup() {
   _arguments \
-    '--browser[Always open the sign-up URL in a browser here, rather than printing it.]' \
-    '--wait[Wait for the sign-up to complete even if no local browser is detected.]' \
-    '--no-wait[Print the sign-up URL and exit without waiting. Leaves this CLI a guest.]' \
+    '--guest[Start working as an anonymous guest instead of signing up — no account or browser needed, so it works anywhere. Your work is saved to a temporary workspace you can keep later by running `postman signup`.]' \
     '--json[Print the sign-up details as machine-readable JSON.]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -134,8 +136,18 @@ _postman_whoami() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_feedback() {
+  _arguments \
+    '--type[Feedback type\: cli_gap, improvement_suggestion, bug_report, feature_request, general (default\: general)]:type' \
+    '--context[Command or feature context this feedback is about]:context' \
+    '--json[Print result as machine-readable JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:text:'
+}
+
 _postman_update() {
   _arguments \
+    '--check[Check whether a Postman CLI update is available.]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -197,6 +209,7 @@ _postman_collection() {
         lint) _postman_collection_lint ;;
         ai-readiness) _postman_collection_ai_readiness ;;
         get) _postman_collection_get ;;
+        request) _postman_collection_request ;;
         list) _postman_collection_list ;;
         run) _postman_collection_run ;;
       esac
@@ -212,6 +225,7 @@ _postman_collection_commands() {
     'lint:Run linting on a local v3 collection at the given file or directory path.'
     'ai-readiness:Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
     'get:Fetch a Postman collection in the V3 format and print it.'
+    'request:Add, update, or remove requests in a local v3 collection.'
     'list:List collections\: your local project'\''s collections by default, or a Postman cloud workspace'\''s collections with --workspace.'
     'run:Initiate a Postman collection run from a given ID or path.'
   )
@@ -259,6 +273,78 @@ _postman_collection_get() {
     '*:id:'
 }
 
+_postman_collection_request() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_collection_request_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        add) _postman_collection_request_add ;;
+        update) _postman_collection_request_update ;;
+        rm|remove) _postman_collection_request_rm ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_collection_request_commands() {
+  local -a sub
+  sub=(
+    'add:Add an empty request to a local v3 collection (set its details later with `update`).'
+    'update:Update a request in a v3 collection (only the fields you pass).'
+    'rm:Remove a request (any type) from a v3 collection.'
+    'remove:Alias for rm'
+  )
+  _describe -t commands 'request command' sub
+}
+
+_postman_collection_request_add() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path. Required.]:id|name' \
+    '--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' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:request-name:'
+}
+
+_postman_collection_request_update() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
+    '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
+    '--rename[Rename the request (moves its file). Any request type.]:name' \
+    '--url[Request URL. Any request type.]:url' \
+    '--method[HTTP method (http requests only).]:method' \
+    '--param[Replace query parameters. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '(-d --body)'{-d,--body}'[Request payload (inline, @file, or - for stdin), interpreted by request type. For http, an optional "<type>\:" prefix picks the content type\: json/text/xml/html/javascript, file\:<path>, urlencoded\:key=v&k2=v2, or formdata\:key=v&file=@path.]:body' \
+    '--variables[GraphQL variables JSON (graphql requests only).]:json' \
+    '--description[Request description.]:text' \
+    '--headers[Replace request headers. Repeatable; any request type with headers. (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--auth[Request auth\: none, inherit, bearer\:TOKEN, basic\:USER\:PASS, apikey\:KEY\:VALUE\[\:header|query\], oauth2\:TOKEN. Any request type.]:spec' \
+    '--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' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:request:'
+}
+
+_postman_collection_request_rm() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
+    '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
+    '(-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' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:request:'
+}
+
 _postman_collection_list() {
   _arguments \
     '(-w --workspace)'{-w,--workspace}'[List a Postman cloud workspace'\''s collections by id. Omit to list the local project'\''s collections.]:workspaceId' \
@@ -553,9 +639,9 @@ _postman_runner() {
 _postman_runner_commands() {
   local -a sub
   sub=(
-    'start:Start a runner'
-    'list:List the team'\''s registered self-hosted runners'
-    'regions:List the region and private-runner values valid for monitor create/update --runner, including a static IP where configured'
+    'start:Start a self-hosted runner in your own network.'
+    'list:List the team'\''s registered self-hosted runners.'
+    'regions:List the region and private-runner values valid for monitor create/update --runner, with the static IP Postman runs each one from, where your team has access to it.'
   )
   _describe -t commands 'runner command' sub
 }
@@ -564,15 +650,16 @@ _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[Specify the region for the runner. Use "eu" for EU region.]:region' \
-    '--proxy[External proxy URL (e.g., http\://proxy.com or http\://proxy.com\:8080)]:url' \
+    '--region[Region this runner reports to -- use "eu" for the EU 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' \
     '--ssl-extra-ca-certs[Additional trusted CA certificates (PEM file, can contain multiple certs)]:path:_files -g "*.(pem|crt|key)"' \
+    '--dataset-jdbc-driver-dir[Folder on this machine holding the JDBC driver .jar files you put there. Required to run a dataset that uses a JDBC source. Drivers are loaded only from this folder and matched by file name; driver paths saved in the dataset are ignored]:path:_files -/' \
     '--metrics[Enable the metrics server for health checks]' \
     '--metrics-port[Port for the metrics server (default\: "9090")]:port' \
-    '--report-events[Accepted for compatibility; analytics are sent by default]' \
-    '--no-report-events[Do not send analytics to Postman]' \
+    '--report-events[Accepted for compatibility; run events are reported by default]' \
+    '--no-report-events[Do not report run events to Postman]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
@@ -808,7 +895,7 @@ _postman_monitor_commands() {
 
 _postman_monitor_run() {
   _arguments \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
@@ -821,14 +908,14 @@ _postman_monitor_create() {
   _arguments \
     '(-c --collection)'{-c,--collection}'[Collection to monitor -- accepts the id shown in the Postman app, prefixed or bare]:id' \
     '--name[Monitor name (defaults to the linked collection'\''s own name)]:name' \
-    '--environment[Environment to run the monitored collection with]:id' \
+    '(-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' \
-    '--timezone[Time zone for --schedule, e.g. America/New_York (defaults to the host machine'\''s own zone)]:tz' \
+    '--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' \
     '--notify-email[Email to notify on a run failure or error (repeatable) (default\: \[\])]:email' \
-    '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
-    '--retry[Retries on a failed run (service caps this at 2)]:n' \
+    '--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' \
     '--delay[Delay between requests in milliseconds]:ms' \
     '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
@@ -838,9 +925,9 @@ _postman_monitor_create() {
     '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
     '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
     '--iteration-count[Number of iterations to run]:n' \
-    '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
+    '--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)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -849,12 +936,14 @@ _postman_monitor_update() {
   _arguments \
     '--name[New monitor name]:name' \
     '--schedule[New cron expression for the monitor'\''s schedule]:cron' \
-    '--timezone[Time zone for --schedule, e.g. America/New_York (defaults to the host machine'\''s own zone)]:tz' \
+    '--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' \
     '--notify-email[Email to notify on a run failure or error (repeatable; replaces the current list) (default\: \[\])]:email' \
     '--clear-notifications[Remove every notification recipient]' \
-    '--notification-limit[Cap consecutive notifications before they are muted (service range\: 1-99)]:n' \
-    '--retry[Retries on a failed run (service caps this at 2)]:n' \
+    '(-e --environment)'{-e,--environment}'[Environment to run the monitored collection with (replaces the current one)]: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' \
     '--delay[Delay between requests in milliseconds]:ms' \
     '--strict-ssl[Fail the run when the target'\''s TLS certificate cannot be verified]' \
@@ -864,8 +953,8 @@ _postman_monitor_update() {
     '--dataset-id[Dataset to use as iteration data (used together with --dataset-view-id)]:id' \
     '--dataset-view-id[Dataset view to iterate (used together with --dataset-id)]:id' \
     '--iteration-count[Number of iterations to run]:n' \
-    '--iteration-strategy[How iteration data is consumed, e.g. round_robin, repeat_last, stop_at_end (requires --iteration-count, --dataset-id and --dataset-view-id)]:strategy' \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -874,7 +963,7 @@ _postman_monitor_update() {
 _postman_monitor_delete() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -908,9 +997,9 @@ _postman_monitor_jobs_commands() {
 
 _postman_monitor_jobs_list() {
   _arguments \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--result[Filter by outcome, e.g. success, failure, error, abort (server-validated, not a fixed list)]:value' \
-    '--trigger[Filter by trigger, e.g. api, schedule, webhook, postman-cli (server-validated, not a fixed list)]:value' \
+    '--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' \
     '--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' \
@@ -921,7 +1010,7 @@ _postman_monitor_jobs_list() {
 
 _postman_monitor_jobs_get() {
   _arguments \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:jobId:'
@@ -953,8 +1042,8 @@ _postman_monitor_runs_commands() {
 
 _postman_monitor_runs_get() {
   _arguments \
-    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--attempt[Which attempt of the run to show, counting from 0 (default\: the latest)]:n' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -963,18 +1052,17 @@ _postman_monitor_runs_get() {
 
 _postman_monitor_list() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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' \
-    '--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' \
+    '(-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[Max monitors to return. The service caps page size and rejects a value above it with its own error.]:n' \
-    '--offset[Not supported\: the service accepts this parameter and silently ignores it. Refused locally. Use --cursor instead.]:n' \
-    '--cursor[Pagination cursor from a previous page'\''s response.]:token' \
-    '--columns[Comma-separated columns to show. Defaults to Name, Status, ID, Schedule, Owner, Collection. Also available\: State, Notifications, Environment, Runners.]:names' \
+    '--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' \
     '--sort[Sort the returned page by "name" or "active"]:field' \
@@ -984,7 +1072,7 @@ _postman_monitor_list() {
 
 _postman_monitor_get() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -992,11 +1080,11 @@ _postman_monitor_get() {
 
 _postman_monitor_metrics() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--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' \
+    '--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)"' \
+    '--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[Cap the number of rows shown\: executions (newest first) under --json, or table rows (worst-behaving request first) otherwise. Not honoured by the service -- there is no server-side pagination on this route.]:n' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -1004,7 +1092,7 @@ _postman_monitor_metrics() {
 
 _postman_monitor_pause() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -1012,7 +1100,7 @@ _postman_monitor_pause() {
 
 _postman_monitor_resume() {
   _arguments \
-    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--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]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:monitorId:'
@@ -1032,6 +1120,7 @@ _postman_workspace() {
         prepare) _postman_workspace_prepare ;;
         push) _postman_workspace_push ;;
         lint) _postman_workspace_lint ;;
+        get) _postman_workspace_get ;;
         create) _postman_workspace_create ;;
         pull) _postman_workspace_pull ;;
         connect-git) _postman_workspace_connect_git ;;
@@ -1048,6 +1137,7 @@ _postman_workspace_commands() {
     'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
     'push:Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
     'lint:Lint the current local Postman workspace\: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
+    'get:Read a workspace'\''s metadata, and optionally the ids of what it holds.'
     'create:Create a Postman workspace and bind it to this git repository.'
     'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
     'connect-git:Connect a Postman workspace to a local git repository.'
@@ -1093,11 +1183,22 @@ _postman_workspace_lint() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_workspace_get() {
+  _arguments \
+    '--elements[Also report the resources the workspace holds.]' \
+    '--json[Print the workspace as machine-readable JSON.]' \
+    '--timeout[Milliseconds to wait for the API (default 30000).]:ms' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:id:'
+}
+
 _postman_workspace_create() {
   _arguments \
-    '--visibility[Required. Workspace visibility, e.g. personal or team]:status' \
+    '--visibility[Required. One of\: personal, private, team, public, partner.]:status' \
     '--name[Workspace name (defaults to owner/repo from the git remote)]:name' \
     '--summary[Optional workspace summary]:text' \
+    '--team-id[The team inside your organisation the workspace belongs to. Required for a team workspace when your organisation has teams inside it. Find it with `postman team list`.]:id' \
+    '--team-role[What a team or public workspace grants\: view or edit. Applies to the team named by --team-id, or to your whole organisation when none is named. Defaults to your team'\''s configured default.]:level' \
     '--path[Directory to bind (defaults to the current directory)]:dir:_files -g "*.json"' \
     '--no-connect[Create the workspace without binding it to the repository]' \
     '--force[Create even when a workspace is already recorded for this repo]' \
@@ -1132,6 +1233,38 @@ _postman_workspace_diff() {
     '*:workspaceId:'
 }
 
+_postman_team() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_team_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        list) _postman_team_list ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_team_commands() {
+  local -a sub
+  sub=(
+    'list:List the teams inside your organisation.'
+  )
+  _describe -t commands 'team command' sub
+}
+
+_postman_team_list() {
+  _arguments \
+    '--can-create-workspace[Only list teams you could create a workspace in.]' \
+    '--json[Print the list as machine-readable JSON.]' \
+    '--timeout[Abort the run after this many milliseconds. Defaults to 30000.]:ms' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_performance() {
   local context state state_descr line
   typeset -A opt_args
@@ -1143,7 +1276,7 @@ _postman_performance() {
     args)
       case $words[1] in
         run) _postman_performance_run ;;
-        runs) _postman_performance_runs ;;
+        list) _postman_performance_list ;;
       esac
       ;;
   esac
@@ -1153,7 +1286,7 @@ _postman_performance_commands() {
   local -a sub
   sub=(
     'run:Run a performance test on a collection'
-    'runs:List past performance runs for a collection, newest first.'
+    'list:List past performance runs for a collection, newest first.'
   )
   _describe -t commands 'performance command' sub
 }
@@ -1172,6 +1305,7 @@ _postman_performance_run() {
     '--dataset-view-id[Dataset view to execute for iteration data (requires --dataset-id)]:id' \
     '--dataset-distribution[How rows map to VUs\: round-robin (default), fixed, random]:strategy' \
     '--postman-api-key[API Key used to load the resources from the Postman API (Only supported in the US region, use '\''postman login --region'\'' to authenticate instead)]:apiKey' \
+    '--output[Output format for live results\: auto (default, interactive dashboard) or ndjson (one JSON object per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default\: "auto")]:format' \
     '--runner[Runner to execute the performance test on\: local, postman-cloud, or postman-cloud-static-ip (egress from your account region'\''s static-IP cluster) (default\: local)]:runner' \
     '--pass-if[Pass condition in format\: function(metric, value). Functions\: less_than, greater_than, less_than_eq, greater_than_eq. Metrics\: avg, p90, p95, p99, error_rate, rps. Example\: less_than(p95, 500) or less_than(error_rate, 5)]:condition' \
     '--use-mock[Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format\: "<{{var}}|host> mock|mock-server\:<path|id> \[scenario\]" (default\: \[\])]:mapping' \
@@ -1179,7 +1313,7 @@ _postman_performance_run() {
     '*:collectionId:_files -g "*.json"'
 }
 
-_postman_performance_runs() {
+_postman_performance_list() {
   _arguments \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID whose performance runs to list]:id' \
     '--cursor[Pagination cursor from a previous page'\''s response]:token' \
@@ -1743,29 +1877,29 @@ _postman_simulate_run() {
     '*:filepath:_files -g "*.json"'
 }
 
-_postman_context() {
+_postman_describe() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_commands' \
+    '1: :_postman_describe_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        instructions) _postman_context_instructions ;;
-        collection) _postman_context_collection ;;
-        request) _postman_context_request ;;
-        folder) _postman_context_folder ;;
-        response) _postman_context_response ;;
-        workspace) _postman_context_workspace ;;
-        environment) _postman_context_environment ;;
+        instructions) _postman_describe_instructions ;;
+        collection) _postman_describe_collection ;;
+        request) _postman_describe_request ;;
+        folder) _postman_describe_folder ;;
+        response) _postman_describe_response ;;
+        workspace) _postman_describe_workspace ;;
+        environment) _postman_describe_environment ;;
       esac
       ;;
   esac
 }
 
-_postman_context_commands() {
+_postman_describe_commands() {
   local -a sub
   sub=(
     'instructions:Get agent instructions for using Postman Context with AI coding agents.'
@@ -1776,32 +1910,32 @@ _postman_context_commands() {
     'workspace:Workspace commands'
     'environment:Environment commands'
   )
-  _describe -t commands 'context command' sub
+  _describe -t commands 'describe command' sub
 }
 
-_postman_context_instructions() {
+_postman_describe_instructions() {
   _arguments \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:topic:'
 }
 
-_postman_context_collection() {
+_postman_describe_collection() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_collection_commands' \
+    '1: :_postman_describe_collection_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_collection_get ;;
+        get) _postman_describe_collection_get ;;
       esac
       ;;
   esac
 }
 
-_postman_context_collection_commands() {
+_postman_describe_collection_commands() {
   local -a sub
   sub=(
     'get:Get a collection'\''s metadata and a map of its folders and requests. Returns collection info (name, description, variables, auth) plus a recursive tree of folders and requests.'
@@ -1809,30 +1943,30 @@ _postman_context_collection_commands() {
   _describe -t commands 'collection command' sub
 }
 
-_postman_context_collection_get() {
+_postman_describe_collection_get() {
   _arguments \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_request() {
+_postman_describe_request() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_request_commands' \
+    '1: :_postman_describe_request_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_request_get ;;
-        context) _postman_context_request_context ;;
+        get) _postman_describe_request_get ;;
+        context) _postman_describe_request_context ;;
       esac
       ;;
   esac
 }
 
-_postman_context_request_commands() {
+_postman_describe_request_commands() {
   local -a sub
   sub=(
     'get:Get a request from a collection'
@@ -1841,37 +1975,37 @@ _postman_context_request_commands() {
   _describe -t commands 'request command' sub
 }
 
-_postman_context_request_get() {
+_postman_describe_request_get() {
   _arguments \
     '(-r --request-id)'{-r,--request-id}'[Request ID]:id' \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_request_context() {
+_postman_describe_request_context() {
   _arguments \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID]:id' \
     '(-r --request-id)'{-r,--request-id}'[Request ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_folder() {
+_postman_describe_folder() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_folder_commands' \
+    '1: :_postman_describe_folder_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_folder_get ;;
+        get) _postman_describe_folder_get ;;
       esac
       ;;
   esac
 }
 
-_postman_context_folder_commands() {
+_postman_describe_folder_commands() {
   local -a sub
   sub=(
     'get:Get a folder from a collection'
@@ -1879,30 +2013,30 @@ _postman_context_folder_commands() {
   _describe -t commands 'folder command' sub
 }
 
-_postman_context_folder_get() {
+_postman_describe_folder_get() {
   _arguments \
     '--folder-id[Folder ID]:id' \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_response() {
+_postman_describe_response() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_response_commands' \
+    '1: :_postman_describe_response_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_response_get ;;
+        get) _postman_describe_response_get ;;
       esac
       ;;
   esac
 }
 
-_postman_context_response_commands() {
+_postman_describe_response_commands() {
   local -a sub
   sub=(
     'get:Get a saved response example from a collection'
@@ -1910,7 +2044,7 @@ _postman_context_response_commands() {
   _describe -t commands 'response command' sub
 }
 
-_postman_context_response_get() {
+_postman_describe_response_get() {
   _arguments \
     '--id[Response ID]:id' \
     '(-c --collection-id)'{-c,--collection-id}'[Collection ID]:id' \
@@ -1918,23 +2052,23 @@ _postman_context_response_get() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_workspace() {
+_postman_describe_workspace() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_workspace_commands' \
+    '1: :_postman_describe_workspace_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_workspace_get ;;
+        get) _postman_describe_workspace_get ;;
       esac
       ;;
   esac
 }
 
-_postman_context_workspace_commands() {
+_postman_describe_workspace_commands() {
   local -a sub
   sub=(
     'get:Get a workspace by ID'
@@ -1942,29 +2076,29 @@ _postman_context_workspace_commands() {
   _describe -t commands 'workspace command' sub
 }
 
-_postman_context_workspace_get() {
+_postman_describe_workspace_get() {
   _arguments \
     '(-w --workspace-id)'{-w,--workspace-id}'[Workspace ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
-_postman_context_environment() {
+_postman_describe_environment() {
   local context state state_descr line
   typeset -A opt_args
   _arguments -C \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '1: :_postman_context_environment_commands' \
+    '1: :_postman_describe_environment_commands' \
     '*::arg:->args'
   case $state in
     args)
       case $words[1] in
-        get) _postman_context_environment_get ;;
+        get) _postman_describe_environment_get ;;
       esac
       ;;
   esac
 }
 
-_postman_context_environment_commands() {
+_postman_describe_environment_commands() {
   local -a sub
   sub=(
     'get:Get a single environment by ID'
@@ -1972,7 +2106,7 @@ _postman_context_environment_commands() {
   _describe -t commands 'environment command' sub
 }
 
-_postman_context_environment_get() {
+_postman_describe_environment_get() {
   _arguments \
     '(-e --environment-id)'{-e,--environment-id}'[Environment ID]:id' \
     '(-h --help)'{-h,--help}'[display help for command]'
@@ -2316,6 +2450,7 @@ _postman_dataset() {
         delete) _postman_dataset_delete ;;
         source) _postman_dataset_source ;;
         view) _postman_dataset_view ;;
+        jdbc) _postman_dataset_jdbc ;;
       esac
       ;;
   esac
@@ -2331,6 +2466,7 @@ _postman_dataset_commands() {
     'delete:Permanently remove a dataset\: a local .dataset.yaml or a cloud dataset id.'
     'source:Inspect and manage a dataset'\''s datasources.'
     'view:Inspect and manage saved views on a dataset.'
+    'jdbc:Inspect JDBC drivers before attaching one to a dataset.'
   )
   _describe -t commands 'dataset command' sub
 }
@@ -2400,6 +2536,7 @@ _postman_dataset_source() {
         add) _postman_dataset_source_add ;;
         remove) _postman_dataset_source_remove ;;
         update) _postman_dataset_source_update ;;
+        test) _postman_dataset_source_test ;;
       esac
       ;;
   esac
@@ -2412,6 +2549,7 @@ _postman_dataset_source_commands() {
     'add:Add a datasource to a dataset.'
     'remove:Remove a datasource from a dataset (local YAML path or cloud id).'
     'update:Update fields on an existing datasource. Only the flags you provide are changed.'
+    'test:Open and close a real connection using a source'\''s stored configuration.'
   )
   _describe -t commands 'source command' sub
 }
@@ -2430,15 +2568,28 @@ _postman_dataset_source_add() {
     '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
     '--source-id[Override the generated source id (local dataset only)]:uuid' \
     '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
-    '--type[Source kind; local is inferred when --file is provided]:local|mysql|postgresql|sqlserver' \
+    '--type[Source kind; local is inferred from --file, jdbc from --driver-jar]:local|mysql|postgresql|sqlserver|jdbc' \
     '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
     '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
     '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
     '--upload[Cloud dataset only\: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem csv/json source read by the local engine.]' \
+    '--driver-jar[JDBC driver JAR(s). Repeatable, or pass several after one flag]:path...:_files -g "*.json"' \
+    '--driver-class[Driver class. Auto-resolved when the JAR contains exactly one]:fqcn' \
+    '--driver-name[Label for this driver type (defaults to the JAR filename)]:label' \
+    '--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"' \
+    '--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' \
     '--port[DB port (defaults to 1433 for sqlserver)]:port' \
-    '--user[DB user (warning\: stored as plaintext in the YAML).]:user' \
-    '--password[DB password. WARNING\: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.]:password' \
+    '--user[DB user. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:user' \
+    '--password[DB password. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:password' \
     '--database[DB database name]:db' \
     '--table[DB table name (required for sqlserver)]:table' \
     '--ssh-host[SSH bastion host]:host' \
@@ -2476,10 +2627,22 @@ _postman_dataset_source_update() {
     '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
     '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
     '--force[With --file, overwrite the copied destination (local dataset only)]' \
+    '--driver-jar[Replace the JDBC driver JAR(s)]:path...:_files -g "*.json"' \
+    '--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...' \
+    '--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"' \
+    '--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' \
     '--port[Update DB port]:port' \
-    '--user[Update DB user (warning\: stored as plaintext in the YAML).]:user' \
-    '--password[Update DB password. WARNING\: passing it here exposes it in `ps` output and shell history, and it is stored as plaintext in the dataset YAML (local) or sent in the request body (cloud). Prefer a restricted DB user; secure input (prompt / stdin / env) is planned.]:password' \
+    '--user[Update DB user. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:user' \
+    '--password[Update DB password. WARNING\: a literal value is visible in `ps` output and shell history, and is stored in clear text in the dataset YAML (local) or sent in the request body (cloud). Prefer a Shared Vault reference.]:password' \
     '--database[Update DB database name]:db' \
     '--table[Update DB table name]:table' \
     '--ssh-host[Update SSH bastion host]:host' \
@@ -2497,10 +2660,21 @@ _postman_dataset_source_update() {
     '--host-name-in-certificate[Update SQL Server certificate hostname override]:hostname' \
     '--tls-min-version[Update SQL Server minimum TLS version]:1.2|1.3' \
     '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Emit the result as JSON instead of prose]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:sourceNameOrId:'
 }
 
+_postman_dataset_source_test() {
+  _arguments \
+    '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
+    '(-n --name)'{-n,--name}'[Source to test]:name' \
+    '--java-path[Java runtime to use for a JDBC source. Machine-local only; also read from POSTMAN_JDBC_JAVA_PATH]:path:_files -g "*.json"' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Emit the result as JSON instead of prose]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_dataset_view() {
   local context state state_descr line
   typeset -A opt_args
@@ -2557,7 +2731,9 @@ _postman_dataset_view_create() {
     '(-d --dataset)'{-d,--dataset}'[Dataset to add the view to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[View name]:name' \
     '(-q --query)'{-q,--query}'[SQL query the view executes]:sql' \
+    '(-s --source)'{-s,--source}'[Bind the view to one datasource and run the query natively against it, instead of through the federated SQLite layer. Same reference `dataset query -s` takes]:nameOrIdOrSlug' \
     '--view-id[Override the generated view id (local only; cloud assigns its own)]:uuid' \
+    '--json[Emit the result as JSON instead of prose]' \
     '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -2580,6 +2756,40 @@ _postman_dataset_view_update() {
     '*:viewNameOrId:'
 }
 
+_postman_dataset_jdbc() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_dataset_jdbc_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        inspect) _postman_dataset_jdbc_inspect ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_dataset_jdbc_commands() {
+  local -a sub
+  sub=(
+    'inspect:Detect Java, list driver classes, suggest a URL template and read driver properties.'
+  )
+  _describe -t commands 'jdbc command' sub
+}
+
+_postman_dataset_jdbc_inspect() {
+  _arguments \
+    '--driver-class[Introspect this class instead of auto-selecting]:fqcn' \
+    '--url-template[Use this URL template instead of the one inferred from the JAR filename]:template' \
+    '--java-path[Java runtime to use. Machine-local only — never written to a dataset. Also read from POSTMAN_JDBC_JAVA_PATH.]:path:_files -g "*.json"' \
+    '--json[Emit the discovery result as JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:jar...:'
+}
+
 _postman_dependency() {
   local context state state_descr line
   typeset -A opt_args