---
title: "Rotate to a new exit IP"
method: POST
path: "/api/v1/proxies/{id}/rotate"
tags: ["Proxies"]
---

# Rotate to a new exit IP

`POST /api/v1/proxies/{id}/rotate`

## Request

- Base URL: `https://virtualsms.io`
- URL: `https://virtualsms.io/api/v1/proxies/{id}/rotate`
- Auth: API key in header `X-API-Key`

30-second cooldown between rotations on the same proxy.

## Path parameters

- `id` string, required

## Request body

- object
  - `port` integer: 0 = default HTTP rotating port (823)

## Response `200`

Rotated to a new IP

## Other responses

- `429`: Rotation cooldown active (30s)

---

[API](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and.md) · [All operations](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/llms.txt) · [OpenAPI document](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/revisions/be89af981be1?raw)