# Modificación de la información proxy

Actualiza una configuración de proxy.
- **Requisitos previos**: el proxy debe existir en el equipo. **Los proxies dinámicos no se pueden actualizar** con este endpoint. El proveedor debe ser un valor reconocido.
- **Efecto**: es una sobrescritura completa, no un parche: los campos que omitas vuelven a sus valores por defecto en lugar de conservar los actuales. Lee primero el proxy y envíalo de vuelta completo.
- **Propagación**: los perfiles conservan su vinculación porque solo cambia el registro del proxy, pero un navegador o Cloud Phone que ya esté en ejecución sigue usando los datos de conexión con los que arrancó. Reinícialo para que adopte los nuevos.
- **Finalización**: sincrónica. Sin bloqueo optimista, así que las actualizaciones simultáneas se resuelven con la última escritura.

Errores de negocio documentados: `14003`, `14023`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

## Request fields (application/json):

  - `id` (string, required)
    ID de proxy único

  - `proxyIp` (string, required)
    Dirección IP del servidor proxy

  - `proxyPort` (integer, required)
    Puerto del servidor proxy

  - `proxyName` (string)
    Nombre personalizado para el proxy

  - `country` (string)
    País (por ejemplo, "EE. UU.", "CN")

  - `city` (string)
    Nombre de la ciudad

  - `username` (string)
    Nombre de usuario para autenticación (si es necesario)

  - `password` (string)
    Contraseña de autenticación (si es necesaria)

  - `proxyType` (integer)
    Tipo de protocolo proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH

  - `proxyProvider` (integer, required)
    ID del proveedor de proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
- `4` = Oxylabs
- `5` = Proxys.io
- `6` = GeoSurf
- `7` = Luminati
- `8` = Lumauto
- `9` = Oxylabsauto
- `10` = Troyano
- `11` = Shadowsocks
- `12` = vmess
- `13` = ABCPROXY
- `14` = LunaProxy
- `15` = IPHTML
- `16` = PiaProxy
- `17` = 922S5

  - `encryptionType` (integer)
    Tipo de cifrado (dependiente del proveedor, normalmente 0 para cifrado plano)

  - `ipMonitor` (boolean)
    Habilitar la monitorización de cambios de IP

  - `ipChangeAction` (integer)
    Acción a realizar cuando cambia la IP:
- `1` = Notificar / Actualizar (valor común)

> Consulte la documentación del sistema para ver todas las opciones.

  - `refreshUrl` (string)
    URL para activar la actualización de IP (si el proveedor lo admite)

  - `state` (string)
    Campo reservado o estado personalizado (opcional)

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado devuelto 0: Normal. Los demás códigos son excepciones.

  - `msg` (string | null, required)
    Mensaje de error

  - `requestId` (string, required)
    ID de solicitud de operación