# 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 servicio 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 /proxyInfo/update
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

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

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

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

  - `proxyName` (string)
    Nombre personalizado del proxy

  - `country` (string)
    País (por ejemplo, "US", "CN")

  - `city` (string)
    Nombre de la ciudad

  - `username` (string)
    Usuario de autenticación (si es necesario)

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

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

  - `proxyProvider` (integer, required)
    ID del tipo de proxy:
- `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)
    Tipo de cifrado (propio del servicio; normalmente 0 para sin cifrar)

  - `ipMonitor` (boolean)
    Activar la supervisión de cambios de IP

  - `ipChangeAction` (integer)
    Acción que se toma cuando cambia la IP:
- `1` = Notificar / Actualizar (valor habitual)

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

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

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

## Response 200:

  - `200` (unknown)
    Correcto. Esta operación no devuelve carga útil; el resultado lo transmite `code`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica éxito; otros códigos indican excepciones.

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

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