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
      • 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
  • Locate your error
  • Use Repro Mode
  • Debug your endpoint with Repro Mode
  • Known limitations of Repro Mode
  • Debugging in different environments
Postman Insights

Debug with Insights

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

Install Postman Insights Agent on AWS Elastic Beanstalk

Next

Customize your Postman Insights

Built with

Repro Mode aims to make it seamless to rerun requests using real user data from production. The Insights Agent prefills the data for you from the observed traffic, eliminating the need to check logs and traces to find the elements needed to send the request and fix your failing endpoint.

Before you can reproduce your errors, you need to decide which data needs to be redacted and turn on Repro Mode in the Settings tab.

Locate your error

If you know you have an error but don’t know exactly which endpoint, or if you are wondering whether you have errors at all, the Error overview page provides details you can select to inspect the cause of your errors.

Use Repro Mode

Before you begin, check that the Repro Mode is enabled in the Settings tab. This procedure assumes that you enabled the --repro-mode flag during your Insights Agent configuration.

You can access Repro Mode from an Error details page, which you get to by selecting an endpoint from the Overview, Errors, and Endpoints tabs.

To use Repro Mode, select the Run dropdown.

Access Insights Repro Mode

Clicking Original request takes you to Postman’s request builder, where you can reproduce your error.

Debug your endpoint with Repro Mode

To debug a failing endpoint, do the following:

  1. From the Errors tab, search and filter endpoints by time range, error code, host, or method. You can also use text search.

    Sort errors
  2. Select a failed request you want to inspect and reproduce. Then, expand it to observe the endpoint details such as request, headers, response, and query parameters, if any.

    Request details
  3. Click Run to open Postman’s request builder.

  4. Click Send to reproduce the error.

  5. In the response pane, select Save as example to capture the error response.

Known limitations of Repro Mode

As the Postman Insights team continues to improve automation around Repro Mode, you may need to manually substitute values in the Repro Mode settings. Known instances of this requirement include:

  • URLs and authorization.

  • Redacted sensitive values, like keys.

  • Resources that do not exist in pre-production environments, for instance, collection IDs and user IDs.

Debugging in different environments

If, for example, you choose to debug a specific error, you can try to run the request in different environments or using Bifrost. Suppose you choose to use a beta environment to replicate your 403 error. If you try to send it, you might get User not found, and the reason can be that the user token is missing. You can paste the access token of your beta environment and replicate the issue.