# Modificando informações de proxy

Atualiza uma configuração de proxy.
- **Pré-requisitos**: o proxy precisa existir na equipe. **Proxies dinâmicos não podem ser atualizados** por este endpoint. O serviço precisa ser um valor reconhecido.
- **Efeito**: é uma sobrescrita completa, não um patch: os campos que você omitir voltam aos valores padrão em vez de manter os atuais. Leia o proxy primeiro e envie-o de volta completo.
- **Propagação**: os perfis mantêm o vínculo porque só o registro do proxy muda, mas um navegador ou Cloud Phone que já esteja em execução continua usando os dados de conexão com que iniciou. Reinicie-o para adotar os novos.
- **Conclusão**: sincrônica. Sem bloqueio otimista, então atualizações simultâneas são resolvidas pela última escrita.

Erros de negócio documentados: `14003`, `14023`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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 do proxy

  - `proxyIp` (string, required)
    Endereço IP do servidor proxy

  - `proxyPort` (integer, required)
    Porta do servidor proxy

  - `proxyName` (string)
    Nome personalizado do proxy

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

  - `city` (string)
    Nome da cidade

  - `username` (string)
    Usuário de autenticação (se necessário)

  - `password` (string)
    Senha de autenticação (se necessária)

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

  - `proxyProvider` (integer, required)
    ID do 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 criptografia (específico do serviço; normalmente 0 para sem criptografia)

  - `ipMonitor` (boolean)
    Ativar o monitoramento de mudanças de IP

  - `ipChangeAction` (integer)
    Ação a executar quando o IP muda:
- `1` = Notificar / Atualizar (valor comum)

> Consulte a documentação do sistema para ver todas as opções.

  - `refreshUrl` (string)
    URL para acionar a atualização do IP (se o serviço suportar)

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

## Response 200:

  - `200` (unknown)
    Sucesso. Esta operação não retorna carga útil; o resultado é informado por `code`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica sucesso; outros códigos indicam exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `requestId` (string, required)
    ID da solicitação da operação