Modify Token

Modifies a token with the provided parameters. At least one optional field must be provided.

PATCH/isp/token

Authentication

Basic user:pass authentication

Request Body

Field	Type	Required	Description
token	string	Required	The token to modify
authType	string	Optional	Authentication type: "user" or "ip" Validation: Must be "user" or "ip"
authenticatedIps	array[string]	Optional	Array of IPv4 addresses for IP authentication. If not provided or if an empty array is provided when switching to IP auth, defaults to ["1.1.1.1"]. When switching authType from "user" to "ip" without providing authenticatedIps, the username and password fields are preserved. Validation: Each string must be a valid IPv4 address. Maximum 4 IP addresses allowed. Empty arrays are accepted and will default to ["1.1.1.1"]. Default: ["1.1.1.1"] (if authType is "ip" and authenticatedIps is not provided or is an empty array)
proxyType	string	Optional	Proxy type Validation: Must be "http" or "socks"
username	string	Optional	Username for authentication Validation: 4-12 alphanumeric characters
password	string	Optional	Password for authentication Validation: 4-12 alphanumeric characters

token

Required

Type:string

Description:

The token to modify

authType

Optional

Type:string

Description:

Authentication type: "user" or "ip"

Validation:

Must be "user" or "ip"

authenticatedIps

Optional

Type:array[string]

Description:

Array of IPv4 addresses for IP authentication. If not provided or if an empty array is provided when switching to IP auth, defaults to ["1.1.1.1"]. When switching authType from "user" to "ip" without providing authenticatedIps, the username and password fields are preserved.

Validation:

Each string must be a valid IPv4 address. Maximum 4 IP addresses allowed. Empty arrays are accepted and will default to ["1.1.1.1"].

Default:["1.1.1.1"] (if authType is "ip" and authenticatedIps is not provided or is an empty array)

proxyType

Optional

Type:string

Description:

Proxy type

Validation:

Must be "http" or "socks"

username

Optional

Type:string

Description:

Username for authentication

Validation:

4-12 alphanumeric characters

password

Optional

Type:string

Description:

Password for authentication

Validation:

4-12 alphanumeric characters

Code Example

NodeJS

const axios = require('axios');

const url = "https://api.unknownproxies.com/api/v1/isp/token";
const headers = {
  "Authorization": "Basic dXNlcjpwYXNz",
  "Content-Type": "application/json"
};
const data = {
  "token": "your-token-here",
  "password": "your-new-password-here"
};

try {
  const response = await axios.patch(url, {
    headers,
    data
  });
  console.log(response.data);
} catch (error) {
  console.error('Error:', error.response?.data || error.message);
}

Python

import requests
import json

url = "https://api.unknownproxies.com/api/v1/isp/token"
headers = {
    "Authorization": "Basic dXNlcjpwYXNz",
    "Content-Type": "application/json"
}
data = {
  "token": "your-token-here",
  "password": "your-new-password-here"
}

response = requests.patch(
    url,
    headers=headers,
    json=data
)

print(response.json())

PHP

<?php
$url = "https://api.unknownproxies.com/api/v1/isp/token";
$headers = [
    "Authorization: Basic dXNlcjpwYXNz",
    "Content-Type: application/json"
];
$data = {
  "token": "your-token-here",
  "password": "your-new-password-here"
};

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.google.gson.Gson;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        
        String url = "https://api.unknownproxies.com/api/v1/isp/token";
        String auth = "Basic dXNlcjpwYXNz";
        
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", auth)
            .header("Content-Type", "application/json");
        
        // Add request body if needed
        String jsonBody = {
  "token": "your-token-here",
  "password": "your-new-password-here"
};
        
        HttpRequest request = requestBuilder
            .patch(HttpRequest.BodyPublishers.ofString(jsonBody))
            .build();
        
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

C#

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using System.Net.Http.Headers;
using Newtonsoft.Json;

public class Program
{
    public static async Task Main()
    {
        using var client = new HttpClient();
        
        var url = "https://api.unknownproxies.com/api/v1/isp/token";
        
        // Set basic auth
        var authToken = Convert.ToBase64String(Encoding.UTF8.GetBytes("user:pass"));
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", authToken);
        
        
        var data = new {
            // Define your request object here
        };
        var json = JsonConvert.SerializeObject(data);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        
        var response = await client.patchAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(result);
    }
}

cURL

curl -X PATCH "https://api.unknownproxies.com/api/v1/isp/token" \
  -H "Authorization: Basic dXNlcjpwYXNz" \
  -H "Content-Type: application/json" \
  -d '{
  "token": "your-token-here",
  "password": "your-new-password-here"
}'

Javascript

const response = await fetch("https://api.unknownproxies.com/api/v1/isp/token", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic dXNlcjpwYXNz",
    "Content-Type": "application/json"
  },
  body: {
    "token": "your-token-here",
    "password": "your-new-password-here"
  }
});

const data = await response.json();
console.log(data);

Go

package main

import (
    "bytes"
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.unknownproxies.com/api/v1/isp/token"
    reqBody := `
{
  "token": "your-token-here",
  "password": "your-new-password-here"
}
`

    var body io.Reader
    if reqBody != "" {
        var buf bytes.Buffer
        if err := json.Compact(&buf, []byte(reqBody)); err == nil {
            body = bytes.NewBuffer(buf.Bytes())
        } else {
            body = bytes.NewBuffer([]byte(reqBody))
        }
    }

    req, _ := http.NewRequest("PATCH", url, body)
    token := base64.StdEncoding.EncodeToString([]byte("user:pass"))
    req.Header.Set("Authorization", "Basic "+token)
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    b, _ := io.ReadAll(resp.Body)
    fmt.Println(string(b))
}

Response Example

{
  "token": "zu8sBXS4gkh7",
  "username": "kGyohRdaGo",
  "authType": "user",
  "password": "bkXBberMQ7",
  "proxyType": "http",
  "authenticatedIps": [],
  "proxies": [
    "123.123.123.123:12345",
    "123.123.111.111:8888"
  ],
  "durationHours": 720,
  "status": "active",
  "createdAt": 1752251968,
  "updatedAt": 1754843968,
  "dataUsage": 11574848653,
  "region": "US",
  "product": "TICK",
  "quantity": 2
}

What Can Be Modified

You can modify the following aspects of an ISP token:

• Auth Type (authType) - Switch between "user" (username/password) and "ip" (IP-based) authentication
• Authenticated IPs (authenticatedIps) - Update the list of allowed IP addresses for IP authentication
• Proxy Type (proxyType) - Switch between "http" and "socks" proxy protocols
• Username (username) - Change the username for user authentication
• Password (password) - Change the password for user authentication

Note

At least one optional field must be provided when modifying a token. Only tokens with status "active" can be modified. Tokens with status "processing" cannot be modified - please wait until the token status becomes "active" before attempting to modify it.

Proxy Type Modification

The proxy IPs only support the protocol specified by proxyType. "http" refers to HTTP/HTTPS requests, while "socks" refers to SOCKS5 requests. A set of proxies cannot support both HTTP and SOCKS simultaneously

Related Operations

• Retrieve Token - Get current token information before modifying
• Renew Token - Extend token duration (cannot be done via PATCH)
• Delete Token - Permanently deactivate the token