POST
/
zone
/
ips
/
refresh
cURL
curl --request POST \
  --url https://api.brightdata.com/zone/ips/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "zone": "zone1",
  "vips": [
    "vip1",
    "vip2"
  ],
  "ips": [
    "ip1",
    "ip2"
  ],
  "country": "<string>",
  "country_city": "<string>"
}'
{
  "vips": [
    {
      "vip": "tr_9121_07_antalya_10",
      "country": "tr"
    },
    {
      "vip": "tr_9121_07_antalya_17",
      "country": "tr"
    }
  ]
}
Warning: This API can modify your account settings, damage your operations or incur charges.
将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌Create an account, generate an API key
每个专用住宅 IP 刷新费用为每个 IP 每次刷新 $0.02

Authorizations

​
Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Body

application/json
​
zone
string
required

Zone name

Example:

"zone1"

​
vips
string[]

IPs to refresh

Note: If refresh is needed for all allocated IPs, then vips parameter should be omitted.

Note: Only works for Dedicated Residential IPs

Example:
["vip1", "vip2"]
​
ips
string[]

IPs to refresh

Note: If refresh is needed for all allocated IPs, then ips parameter should be omitted

Example:
["ip1", "ip2"]
​
country
string

new IPs' country (e.g. us)

​
country_city
string

new IPs' city (e.g. us-chicago)

Response

200 - application/json

OK

The response is of type object.