***

title: Debug with Insights
updated: 2025-09-03T00:00:00.000Z
max-toc-depth: 2
----------------

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.

<Info class="iconless-callout">
  **Coming soon:** You'll be able to use Repro Mode to replicate bugs and errors in lower environments, such as staging or development, where deeper debugging is possible.
</Info>

Before you can reproduce your errors, you need to decide which data needs to be redacted and turn on Repro Mode in the [**Settings**](/docs/insights/reference/app/settings-tab/) 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, there are a couple of ways to find them:

* From the [**Global insights**](/docs/insights/reference/app/global-insights/) page.

* From the [**Error overview**](/docs/insights/reference/app/errors-tab/#errors-overview) page.

* From the [**Alerts**](/docs/insights/reference/app/alerts-tab/) page.

Each of these pages provides error details you can select to inspect the cause of your errors.

## Analyze your alert AI summary

If you [integrate your alerts with Slack](/docs/insights/reference/app/alerts-tab/#configure-insights-alerts), you'll receive notifications about your errors in real time. You can click **Endpoint details** to get more information about your error.

<img alt="Get alerts through Slack" src="https://assets.postman.com/postman-docs/v11/insights-slack-integrated-v11.58.png" width="500" />

The **Endpoint details** page displays an option to use AI to get an alerts summary. To enable the AI alerts, click <img alt="Setting icon" src="https://assets.postman.com/postman-docs/aether-icons/descriptive-setting-stroke.svg#icon" width="16px" /> **Settings** in the header, select **Settings > AI**, and activate Agent Mode.

<img alt="Alert AI summary" src="https://assets.postman.com/postman-docs/v11/insights-alert-summary-v11.58.png" />

To get an AI alert summary, do the following:

1. Click **AI Alert Summary**.

   <Info class="iconless-callout">
     **Activate Agent Mode:** If you've not activated Agent Mode, you're prompted to open **Settings** and enable it. Then, you can proceed to the next step.

     <img alt="Enable Agent Mode" src="https://assets.postman.com/postman-docs/v11/insights-agent-mode-prompt-v11.60.png" width="322" />
   </Info>
2. Press **Return** or **Enter** to send the alert summary prompt.

   <img alt="Send summary prompt" src="https://assets.postman.com/postman-docs/v11/insights-summary-prompt-v11.58.png" />

The AI alert summary returns traffic patterns, error details analysis, likely root causes, and a list of recommendations to fix the error.

<img alt="Insights AI results" src="https://assets.postman.com/postman-docs/v11/insights-ai-results-v11.59.png" width="300" />

## Use Repro Mode

<Info class="iconless-callout">
  Before you begin, check that the Repro Mode is enabled in the [**Settings**](/docs/insights/reference/app/settings-tab/) tab. This procedure assumes that you enabled the `--repro-mode` flag during your [Insights Agent configuration](/docs/insights/get-started/overview/).
</Info>

You can access Repro Mode from an [Error details](/docs/insights/reference/app/errors-tab/#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.

<img alt="Access Insights Repro Mode" src="https://assets.postman.com/postman-docs/v11/insights-repro-mode-access-v.11.58.png" />

Clicking **Original request** takes you to Postman's [request builder](/docs/sending-requests/requests/), where you can reproduce your error.

<Info class="iconless-callout">
  **Coming soon:** You'll be able to use Bifrost and Access Logs in the future iterations of Postman Insights.
</Info>

## 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.

   <img alt="Sort errors" src="https://assets.postman.com/postman-docs/v11/insights-repro-sort-v11.62.png" />

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.

   <img alt="Request details" src="https://assets.postman.com/postman-docs/v11/insights-request-expanded-v11.62.2.png" />

3. Click **Run** to open Postman's request builder.

   <img alt="Run Repro Mode" src="https://assets.postman.com/postman-docs/v11/insights-repro-run-v11.62.2.png" />

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](/docs/insights/reference/app/settings-tab/). 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

<Info class="iconless-callout">
  In-app support for this feature is coming soon.
</Info>

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.