# Change rotation settings

### **Endpoint:**

<mark style="color:yellow;">`POST`</mark> `https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/list/rotation`

#### **Example:**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/resident/list/rotation
```

### **Response:**

{% tabs %}
{% tab title="200: OK Success response " %}

```json
{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "whitelist": "127.0.0.1,192.168.0.1",
    "rotation": "-1 = rotation, 0 = rotation per request, 1..3600 time in seconds",
    "geo": {
      "country": "US",
      "region": "Washington",
      "city": "Garfield",
      "isp": "FIRST-STEP"
    },
    "export": {
      "ports": 10000,
      "ext": "txt"
    }
  },
  "errors": []
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong API key" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong authorization IP" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response List not found" %}

```json
Same response in case with wrong rotation!

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "not-found",
            "code": 404,
            "customData": null
        },
        {
            "message": "not-found (404)",
            "code": 0,
            "customData": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Path parameter&#x73;**:**

<table data-full-width="false"><thead><tr><th width="153">Name</th><th width="186">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Authorization</td><td><code>&#x3C;Your_API_Key></code></td><td>Your personal API key</td><td></td></tr></tbody></table>

### **Request body:**

<table><thead><tr><th width="108">Name</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>Number</td><td>ID of the list</td></tr><tr><td>rotation</td><td>Number</td><td>The new rotation value whitch you want to set , "'-1' for no rotation (Sticky), '0' for rotation per request, '1' to '3600' for time-based rotation in seconds"</td></tr></tbody></table>