> For the complete documentation index, see [llms.txt](https://docs.hypeproxy.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hypeproxy.io/api/ip-rotation.md).

# 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 %}