For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Postman
PricingEnterprise
Contact SalesSign InSign Up for Free
HomeDocs
HomeDocs
      • Overview
      • Debug with Insights
      • Customize Insights
      • Uninstall Insights Agent
        • Overview
          • Overview
          • API Catalog deployment modes
          • apidump
          • kube inject
          • kube helm-fragment
          • kube tf-fragment
          • ecs add
          • ecs task-def
          • ecs cf-fragment
          • completion
      • FAQ
Postman API Platform

Product

  • Postman Overview
  • Enterprise
  • Spec Hub
  • Flows
  • Agent Mode
  • API Catalog
  • Fern
  • Postman CLI
  • Integrations
  • Workspaces
  • Plans and pricing

API Network

  • App Security
  • Artificial Intelligence
  • Communication
  • Data Analytics
  • Database
  • Developer Productivity
  • DevOps
  • Ecommerce
  • eSignature
  • Financial Services
  • Payments
  • Travel

Resources

  • Postman Docs
  • Academy
  • Community
  • Templates
  • Intergalactic
  • Videos
  • MCP Servers

Legal and Security

  • Legal Terms Hub
  • Terms of Service
  • Postman Product Terms
  • Security
  • Website Terms of Use

Company

  • About
  • Careers and culture
  • Contact us
  • Partner program
  • Customer stories
  • Student programs
  • Press and media
Twitter iconLinkedIn iconGithub iconYouTube iconInstagram iconDiscord icon
Download Postman
Privacy Policy

© 2026 Postman, Inc.

On this page
  • Flags
  • Global flags
Postman InsightsReferenceInsights agent

kube inject command reference

||View as Markdown|
Was this page helpful?
Previous

apidump command reference

Next

kube helm-fragment command reference

Built with

The kube inject command injects the Postman Insights Agent into a Kubernetes deployment and output the result on the command line into a file. See Examples.

Flags

  • -h, --help - Help for inject.
  • --host-allow strings - Allows only HTTP hosts matching regular expressions.
  • --host-exclusions strings - Removes HTTP hosts matching regular expressions.
  • --interfaces strings - List of network interfaces to listen on. Defaults to all interfaces on host.
  • -f, --file string - Path to the Kubernetes YAML file to be injected. Expects to contain a valid deployment manifest. You can use - with the file name to read from standard input.
  • --path-allow strings - Allows only HTTP paths matching regular expressions.
  • --path-exclusions strings - Removes HTTP paths matching regular expressions.
  • --rate-limit float - Number of requests per minute to capture.
  • --repro-mode - Turns on Repro Mode to send request and response payloads to Postman.
  • -o, --output string - Path to the output file. If not specified, the output prints to stdout.
  • -s, --secret string[="true"] - Whether to generate a Kubernetes Secret. If set to "true", the agent adds the secret to the modified Kubernetes YAML file. Specify a path to write the secret to a separate file. If this is done, an output file must also be specified with --output. Default: "false".

Global flags

  • --log-format string - Set to 'color', 'plain' or 'json' to control the log format.
  • --project string - Your Postman Insights project ID.
  • --proxy string - The domain name, IP address, or URL of an HTTP proxy server to use.
  • --repro-mode - Enable Repro Mode.

Notes:

  • The input file must be in YAML format and must contain at least one valid deployment manifest.

  • If the --secret flag is set to a file path, the --output flag must also be set.

Examples

  • Inject the set of deployment manifests found in resources.yml and print the result to standard out. Each injected deployment will send traffic from the endpoint to the Postman Insights Agent.

    $postman-insights-agent kube inject --project projectId -f resources.yml
  • Inject any deployment manifests found in resources.yml similar to the previous run. Also generate and add any secrets required for the Insights Agent to run.

    $postman-insights-agent kube inject -s --project projectId -f resources.yml
  • Output injected resources and any secret manifests to separate files:

    $postman-insights-agent kube inject -s="secret.yml" --project projectId -f in.yml -o out.yml
  • Apply generated resources through pipe using kubectl:

    $postman-insights-agent kube inject -s --project projectId -f in.yml | kubectl apply -f -