# Изменение информации о прокси-сервере

Обновляет конфигурацию прокси.
- **Предварительные условия**: прокси должен существовать в команде. **Динамические прокси через этот эндпоинт обновить нельзя.** Провайдер должен быть распознаваемым значением.
- **Эффект**: это полная перезапись, а не частичное обновление: опущенные вами поля возвращаются к значениям по умолчанию, а не сохраняют текущие. Сначала прочитайте прокси и отправьте его обратно целиком.
- **Область действия**: привязки профилей сохраняются, потому что меняется только сама запись прокси, но уже запущенные браузер или облачный телефон продолжают использовать данные подключения, с которыми они были запущены. Перезапустите их, чтобы применить новые.
- **Завершение**: синхронное. Оптимистичной блокировки нет, поэтому при одновременных обновлениях побеждает последняя запись.

Задокументированные бизнес-ошибки: `14003`, `14023`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

Endpoint: POST /api/proxyInfo/update
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    Уникальный идентификатор прокси

  - `proxyIp` (string, required)
    IP-адрес прокси-сервера

  - `proxyPort` (integer, required)
    Порт прокси-сервера

  - `proxyName` (string)
    Пользовательское имя для прокси-сервера

  - `country` (string)
    Страна (например, «США», «Китай»)

  - `city` (string)
    Название города

  - `username` (string)
    Имя пользователя для аутентификации (при необходимости)

  - `password` (string)
    Пароль для аутентификации (при необходимости)

  - `proxyType` (integer)
    Тип протокола прокси:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH

  - `proxyProvider` (integer, required)
    Идентификатор прокси-провайдера:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
- `4` = Oxylabs
- `5` = Proxys.io
- `6` = GeoSurf
- `7` = Luminati
- `8` = Lumauto
- `9` = Oxylabsauto
- `10` = Trojan
- `11` = Shadowsocks
- `12` = vmess
- `13` = ABCPROXY
- `14` = LunaProxy
- `15` = IPHTML
- `16` = PiaProxy
- `17` = 922S5

  - `encryptionType` (integer)
    Тип шифрования (зависит от провайдера, обычно 0 для обычного шифрования)

  - `ipMonitor` (boolean)
    Включить мониторинг изменений IP-адреса

  - `ipChangeAction` (integer)
    Действие при изменении IP-адреса:
- `1` = Уведомить / Обновить (распространенное значение)

> Полный список параметров см. в документации системы.

  - `refreshUrl` (string)
    URL-адрес для запуска обновления IP-адреса (если поддерживается провайдером)

  - `state` (string)
    Зарезервированное поле или пользовательское состояние (необязательно)

## Response 200 fields (application/json):

  - `code` (integer, required)
    Возвращаемый код результата 0: Нормальный. Остальные коды являются исключениями.

  - `msg` (string | null, required)
    Сообщение об ошибке

  - `requestId` (string, required)
    Идентификатор запроса на операцию