# Breakpoint

### 1. What's it?

Breakpoint is a handy tool to help developers to edit the content of the Request and Response **on the fly**.

It's possible to set a breakpoint on both **Request** or **Response.**

![](/files/-MEVyVnIP9VAXgkb-LUN)

{% hint style="info" %}
If you're using [Atlantis Framework](/atlantis/atlantis-for-ios.md), you could not use Breakpoint. Please consider using a normal proxy.
{% endhint %}

### 2. Main features

Breakpoint tool allows the developer to stop an ongoing Request or incoming Response to modify its data.

* Modify the Request URL, including the Scheme, Host, Path, Port, HTTP Method (Available on Proxyman 2.35.4+)
* Modify HTTP Headers of Request/Response
* Modify Query or Form entry from Requests.
* Modify Authorization/Cookie/Set-Cookie Headers.
* Modify HTTP Body of Request/Response
* Change Response HTTP Status Code.

![Breakpoint on Response](/files/-MhvVZiTBRRVnS8Z50yB)

![Breakpoint on the Request URL (Scheme, Host, Port, Path and Query)](/files/Ty9XKr0PMHIOF1yvT5gp)

#### Breakpoint Actions

| Action  | Meaning                                               |
| ------- | ----------------------------------------------------- |
| Cancel  | Cancel a breakpoint and continue the Request/Response |
| Abort   | Abort the connection and return 503 status code       |
| Execute | Make a request/response with a new change             |

{% hint style="info" %}
Check out Breakpoint Tutorial: [Breakpoint to intercept and edit the requests/response on iOS app](https://proxyman.io/blog/2019/09/Use-Breakpoint-to-intercept-and-edit-request-response-on-iOS-app.html)
{% endhint %}

### 3. Breakpoint with Raw Message

From build 3.1.0, we can modify the Request / Response by using the Raw Message.

\[WIP]

### 4. Breakpoint by the Scripting Tool ✅

If you would like to do Breakpoint in an Automatic way, you should use the [Scripting](/scripting/script.md#1-whats-it) tools, which you can achieve the same result that Breakpoint can do, but in a flexible way by writing Javascript Code.

Please check out this [Snippet Code](/scripting/snippet-code.md#2-common-on-request-and-response) to understand how to use Scripting for Breakpoint.

### 5. Breakpoint with GraphQL Requests

From Proxyman 2.27.0+, Breakpoint can work with GraphQL Request by a specific QueryName. Please check out the following GraphQL Document.

{% content-ref url="/pages/-MQ\_uhE\_Ncnoi5qbw2KX" %}
[GraphQL](/advanced-features/graphql.md)
{% endcontent-ref %}

### 6. How to use

You can simply create a Breakpoint rule by:

1. Right-Click on the Request -> Tools -> Breakpoint
2. Proxyman will open a Breakpoint Window and fill the Matching Rule.
3. Select Breakpoint on Request or Response or both.
4. Click Add to create a rule.
5. Try sending a Request again -> Proxyman will open a Breakpoint and you can modify the data.
6. Click on the Execute Button to send a request/response.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proxyman.com/advanced-features/breakpoint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.