Skip to main content
PATCH
/
v1
/
proxies
/
allocate
/
renew
cURL
curl --request PATCH \
  --url https://cmd.illusory.io/v1/proxies/allocate/renew \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "proxies": {
    "time": [
      {
        "proxy_name": "IL-US-AU1-9999",
        "auto_renew": true,
        "interval": 1
      },
      {
        "proxy_name": "IL-US-AU1-9998",
        "auto_renew": true,
        "interval": 1
      }
    ]
  }
}
'
{
  "ok": true,
  "message": "Sent proxy allocation renew settings successfully.",
  "data": {
    "proxies": {
      "time": [
        {
          "proxy_name": "IL-US-AU1-9999",
          "auto_renew": true,
          "interval": 1
        }
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.illusory.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

You can specify whether you want specific proxies to automatically allocate time when they expire. If enabled, the proxy will automatically renew for the same amount of time as the current period.
If disabled, the proxy will expire and be removed from your account unless you manually allocate time it.

Authorizations

​
Authorization
string
header
required

The Authorization header is used to authenticate with the API using your Master API key. Value is of the format Bearer YOUR_KEY_HERE.

Body

application/json

Allocate proxy details

​
proxies
object
required

Object containing a list of proxies to allocate.

Example:
{
  "time": [
    {
      "proxy_name": "IL-US-AU1-9999",
      "auto_renew": true,
      "interval": 1
    },
    {
      "proxy_name": "IL-US-AU1-9998",
      "auto_renew": true,
      "interval": 1
    }
  ]
}

Response

Server response

​
ok
boolean

Indicates whether the request was successful e.g., true

​
message
string

Success message

Example:

"Sent proxy allocation renew settings successfully."

​
data
object
Example:
{
  "proxies": {
    "time": [
      {
        "proxy_name": "IL-US-AU1-9999",
        "auto_renew": true,
        "interval": 1
      }
    ]
  }
}