# IP Rotation / Renewing

## Introduction

The IP renew feature is available on some types of proxies like 4G proxies, it's a very useful feature that many of our customers use.

{% hint style="success" %}
We are constantly improving this feature, we have reduced the renew speed of 4G proxies from more than 8 seconds to less than 5.
{% endhint %}

We currently support to kinds of IP rotation:

* [Automatic](#configure-automatic-rotation): Define an IP rotation every `X` minutes.
* [Manual](#execute-manual-rotation): Triggers a rotation at the time of the request.

## Configure Automatic Rotation

### Get the IP Renew

Get the renew parameters for a specific [product](/reference/orders-and-purchases/product-details.md).

{% openapi src="/files/gs4oEIFDowGgQW6W05CO" path="/v2/Renews/{productDetailsId}" method="get" %}
[swagger.json](https://3875752105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdX5lpI2Fre91A5ipOw%2Fuploads%2FkaenjPxy480P6u3WD1PU%2Fswagger.json?alt=media\&token=d65d1f23-7d90-4149-af11-e3b4c609807e)
{% endopenapi %}

### Set a IP Renew Delay

Define the delay of renew for a specific [product](/reference/orders-and-purchases/product-details.md), the minimum renew is 1 minute.

{% openapi src="/files/gs4oEIFDowGgQW6W05CO" path="/v2/Renews/{productDetailsId}" method="post" %}
[swagger.json](https://3875752105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdX5lpI2Fre91A5ipOw%2Fuploads%2FkaenjPxy480P6u3WD1PU%2Fswagger.json?alt=media\&token=d65d1f23-7d90-4149-af11-e3b4c609807e)
{% endopenapi %}

### Delete an IP Renew

Remove the IP renew feature for a specific [product](/reference/orders-and-purchases/product-details.md).

{% openapi src="/files/gs4oEIFDowGgQW6W05CO" path="/v2/Renews/{productDetailsId}" method="delete" %}
[swagger.json](https://3875752105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdX5lpI2Fre91A5ipOw%2Fuploads%2FkaenjPxy480P6u3WD1PU%2Fswagger.json?alt=media\&token=d65d1f23-7d90-4149-af11-e3b4c609807e)
{% endopenapi %}

## Execute Manual Rotation

The manual renew will be executed as an [asynchronous operation](/basic-concepts/asynchronous-operations.md), the API will return the related `requestId` of the operation.

So don't worry if the request delay is really fast, it's just because it's asynchronous, the renew will be performed in the background and takes about 5 to 8 seconds.

{% openapi src="/files/gs4oEIFDowGgQW6W05CO" path="/v2/Renews/Execute/{productDetailsId}" method="get" %}
[swagger.json](https://3875752105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdX5lpI2Fre91A5ipOw%2Fuploads%2FkaenjPxy480P6u3WD1PU%2Fswagger.json?alt=media\&token=d65d1f23-7d90-4149-af11-e3b4c609807e)
{% endopenapi %}


---

# 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.hypeproxy.io/api/ip-rotation.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.