#Network mode

Choose which mobile networks a dongle may use: 4G only, 3G only, 2G only, Auto (4G/3G/2G), or a combination the dongle's firmware offers (for example 4G + 3G). Locking a dongle to 4G stops it from falling back to slow 2G (EDGE); Auto is better where 4G coverage is weak.

Only devices with the capability netmode.set can do this (Huawei HiLink dongles). For other device types both endpoints answer 409 unsupported — see device type and capabilities. In the panel: proxy page → Connection → Network mode.

#Read the current mode

Ability: read · 30 requests/min. Reads the dongle live through the node's tunnel (a few seconds).

curl 'https://proxykite.com/api/v1/proxies/7/network-mode' \
  -H "Authorization: Bearer $HYP_TOKEN" \
  -H 'Accept: application/json'

import os
import requests

r = requests.get(
    "https://proxykite.com/api/v1/proxies/7/network-mode",
    headers={"Authorization": f"Bearer {os.environ['HYP_TOKEN']}", "Accept": "application/json"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch('https://proxykite.com/api/v1/proxies/7/network-mode', {
  headers: {
    Authorization: `Bearer ${process.env.HYP_TOKEN}`,
    Accept: 'application/json',
  },
  signal: AbortSignal.timeout(30000),
});
console.log(res.status, await res.json());

<?php
$ch = curl_init('https://proxykite.com/api/v1/proxies/7/network-mode');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('HYP_TOKEN'),
        'Accept: application/json',
    ],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($body, true));

Response 200

{"data": {"proxy_id": 7, "mode": "00", "label": "Auto (4G/3G/2G)", "network_band": "3FFFFFFF", "lte_band": "800C5",
  "options": [{"value": "00", "label": "Auto (4G/3G/2G)"}, {"value": "03", "label": "4G only"},
              {"value": "02", "label": "3G only"}, {"value": "01", "label": "2G only"}],
  "options_source": "dongle", "network_type": "EDGE", "connection_status": "901", "connected": true,
  "signal_bars": 3, "read_at": "2026-10-10T19:10:00+00:00"}}

#Change the mode

Ability: manage · Who: account owner, team admin, or the reseller sub-user the proxy is assigned to · 6 changes a minute per dongle. Switches the mode, then reads it back from the dongle to confirm. The dongle reconnects for a few seconds (open connections through the proxy drop); read the mode again after ~20 s to see the new network_type. IP rotation switches the mode for a moment and always returns to the mode set here.

curl -X PUT 'https://proxykite.com/api/v1/proxies/7/network-mode' \
  -H "Authorization: Bearer $HYP_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"mode":"03"}'

import os
import requests

r = requests.put(
    "https://proxykite.com/api/v1/proxies/7/network-mode",
    headers={"Authorization": f"Bearer {os.environ['HYP_TOKEN']}", "Accept": "application/json"},
    json={"mode": "03"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch('https://proxykite.com/api/v1/proxies/7/network-mode', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.HYP_TOKEN}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"mode":"03"}),
  signal: AbortSignal.timeout(30000),
});
console.log(res.status, await res.json());

<?php
$ch = curl_init('https://proxykite.com/api/v1/proxies/7/network-mode');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('HYP_TOKEN'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{"mode":"03"}',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($body, true));

Response 200 — the same object as above plus changed (false = it was already on that mode; nothing was sent) and previous:

{"ok": true, "data": {"proxy_id": 7, "mode": "03", "label": "4G only", "changed": true, "previous": "00",
  "network_type": "LTE", "connection_status": "900", "…": "…"}}