Skip to main content
POST
/
v1
/
proxies
/
allocate
cURL
curl --request POST \
  --url https://cmd.illusory.io/v1/proxies/allocate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "proxies": {
    "time": [
      {
        "proxy_name": "ILL-US-AU1-9999",
        "interval": 1,
        "period": "weekly"
      },
      {
        "proxy_name": "ILL-US-AU1-9998",
        "interval": 2,
        "period": "monthly"
      }
    ]
  }
}
'
{
  "ok": true,
  "message": "Sent proxy expiration update successfully.",
  "data": {
    "proxies": {
      "time": [
        {
          "proxy_name": "IL-US-AU1-9999",
          "period": "hourly",
          "interval": 1,
          "individual_total": 5
        }
      ]
    },
    "total": 5
  }
}

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.

Allocates time to a proxy server to extend its expiration date. Providing period and interval will extend the proxy’s expiration date by the specified amount of time.
When allocating time to a proxy, funds will be deducted from your Illusory Wallet. Ensure you have sufficient funds before allocating.

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": "ILL-US-AU1-9999",
      "interval": 1,
      "period": "weekly"
    },
    {
      "proxy_name": "ILL-US-AU1-9998",
      "interval": 2,
      "period": "monthly"
    }
  ]
}

Response

Server response

​
ok
boolean

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

​
message
string

Success message

Example:

"Sent proxy expiration update successfully."

​
data
object
Example:
{
  "proxies": {
    "time": [
      {
        "proxy_name": "IL-US-AU1-9999",
        "period": "hourly",
        "interval": 1,
        "individual_total": 5
      }
    ]
  },
  "total": 5
}