> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar tronco SIP

> Atualiza uma configuração de tronco SIP existente

Este endpoint atualiza um tronco SIP existente. Inclua apenas os campos que deseja alterar — atualizações parciais são suportadas. Alterar credenciais, endereço ou configurações de proxy reaprovisiona automaticamente os troncos de infraestrutura de voz afetados.

### Parâmetros de Caminho

<ParamField path="id" type="integer" required>
  O identificador único do tronco SIP a ser atualizado
</ParamField>

### Parâmetros do Corpo

Todos os campos são opcionais. Envie apenas os campos que deseja atualizar.

<ParamField body="phone_number" type="string" optional>
  A extensão SIP ou número de telefone (1-15 caracteres)
</ParamField>

<ParamField body="nickname" type="string" optional>
  Um rótulo curto e amigável para o tronco. Máximo de 50 caracteres. Envie `null` para limpar.
</ParamField>

<ParamField body="sip_username" type="string" optional>
  Nome de usuário para autenticação SIP (3-128 caracteres)
</ParamField>

<ParamField body="sip_password" type="string" optional>
  Senha para autenticação SIP (mínimo de 3 caracteres)
</ParamField>

<ParamField body="sip_address" type="string" optional>
  O endereço do servidor SIP sem porta
</ParamField>

<ParamField body="sip_calling_format" type="string" optional>
  O formato do número de chamada de saída: `+e164`, `e164` ou `national`
</ParamField>

<ParamField body="inbound_authorization_type" type="string" optional>
  Como as chamadas de entrada são autenticadas: `auth` ou `ip`. Ao mudar para `ip`, você também deve fornecer `allowed_inbound_ips`. Ao mudar para `auth`, qualquer lista de IPs existente é limpa.
</ParamField>

<ParamField body="allowed_inbound_ips" type="array" optional>
  Array de endereços IP permitidos para chamadas de entrada. **Obrigatório** quando `inbound_authorization_type` é definido como `ip`.
</ParamField>

<ParamField body="country_code" type="string" optional>
  Código do país ISO 3166-2
</ParamField>

<ParamField body="outbound_proxy" type="boolean" optional>
  Roteia chamadas de saída através de um endereço IP fixo
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseField name="data" type="object">
  O objeto do tronco SIP atualizado (mesmos campos que [Obter tronco SIP](/api-reference/sip-trunks/get-sip-trunk))
</ResponseField>

<ResponseExample>
  ```json 200 Credenciais atualizadas theme={null}
  {
    "message": "Tronco SIP atualizado com sucesso.",
    "data": {
      "id": 42,
      "phone_number": "1000",
      "nickname": "Provedor X — Principal",
      "sip_username": "new_username",
      "sip_address": "sip.provider.com",
      "sip_calling_format": "+e164",
      "inbound_authorization_type": "auth",
      "allowed_inbound_ips": null,
      "outbound_proxy": false,
      "country_code": "US",
      "inbound_trunk_id": "ST_newtrunkid1",
      "outbound_trunk_id": "ST_newtrunkid2",
      "created_at": "2026-03-31T10:00:00.000000Z",
      "updated_at": "2026-03-31T12:00:00.000000Z"
    }
  }
  ```

  ```json 200 Mudou para autenticação IP theme={null}
  {
    "message": "Tronco SIP atualizado com sucesso.",
    "data": {
      "id": 42,
      "phone_number": "1000",
      "nickname": "Provedor X — Principal",
      "sip_username": "myuser",
      "sip_address": "sip.provider.com",
      "sip_calling_format": "+e164",
      "inbound_authorization_type": "ip",
      "allowed_inbound_ips": ["203.0.113.10"],
      "outbound_proxy": false,
      "country_code": "US",
      "inbound_trunk_id": "ST_newtrunkid1",
      "outbound_trunk_id": "ST_yyyyyyyyyyyy",
      "created_at": "2026-03-31T10:00:00.000000Z",
      "updated_at": "2026-03-31T12:00:00.000000Z"
    }
  }
  ```

  ```json 404 Não Encontrado theme={null}
  {
    "error": "Tronco SIP não encontrado."
  }
  ```

  ```json 422 Erro de Validação theme={null}
  {
    "message": "Os dados fornecidos são inválidos.",
    "errors": {
      "allowed_inbound_ips": ["Pelo menos um endereço IP permitido é necessário quando o tipo de autorização é \"ip\"."]
    }
  }
  ```

  ```json 500 Erro de Provisionamento theme={null}
  {
    "error": "Falha ao atualizar o tronco SIP. Por favor, tente novamente ou entre em contato com o suporte."
  }
  ```
</ResponseExample>

### Comportamento de Reaprovisionamento

As seguintes alterações de campo acionam o reaprovisionamento automático dos troncos de infraestrutura de voz:

| Campo alterado | Tronco de entrada | Tronco de saída |
| - | :-: | :-: |
| `sip_username` | Recriado | Recriado |
| `sip_password` | Recriado | Recriado |
| `sip_address` | — | Recriado |
| `phone_number` | Recriado | Recriado |
| `inbound_authorization_type` | Recriado | — |
| `allowed_inbound_ips` | Recriado | — |
| `outbound_proxy` | — | Recriado |

Campos como `sip_calling_format`, `country_code` são armazenados localmente e não acionam reaprovisionamento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.