---
title: "PUT /voice-connectors/{voiceConnectorId}/origination"
method: PUT
path: "/voice-connectors/{voiceConnectorId}/origination"
---

# PUT /voice-connectors/{voiceConnectorId}/origination

`PUT /voice-connectors/{voiceConnectorId}/origination`

Updates a Voice Connector's origination settings.

## Path parameters

- `voiceConnectorId` string, required

## Request body

- object
  - `Origination` object, required — <p>Origination settings enable your SIP hosts to receive inbound calls using your Amazon Chime SDK Voice Connector.</p> <note> <p>The parameters listed below are not required, but you must use at least one.</p> </note>
    - `Routes` OriginationRoute[] — The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20. This parameter is not required, but you must specify this parameter or <code>Disabled</code>.
      - `Host` string — The FQDN or IP address to contact for origination traffic.
      - `Port` integer — The designated origination route port. Defaults to 5060.
      - `Protocol` 'TCP' | 'UDP' — The protocol to use for the origination route. Encryption-enabled Amazon Chime SDK Voice Connectors use TCP protocol by default.
      - `Priority` integer — The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.
      - `Weight` integer — The weight assigned to an origination route. When hosts have equal priority, calls are distributed between them based on their relative weights.
    - `Disabled` boolean — When origination settings are disabled, inbound calls are not enabled for your Amazon Chime SDK Voice Connector. This parameter is not required, but you must specify this parameter or <code>Routes</code>.

## Response `200`

Success

- PutVoiceConnectorOriginationResponse
  - `Origination` object — The updated origination settings.
    - `Routes` OriginationRoute[] — The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20. This parameter is not required, but you must specify this parameter or <code>Disabled</code>.
      - `Host` string — The FQDN or IP address to contact for origination traffic.
      - `Port` integer — The designated origination route port. Defaults to 5060.
      - `Protocol` 'TCP' | 'UDP' — The protocol to use for the origination route. Encryption-enabled Amazon Chime SDK Voice Connectors use TCP protocol by default.
      - `Priority` integer — The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.
      - `Weight` integer — The weight assigned to an origination route. When hosts have equal priority, calls are distributed between them based on their relative weights.
    - `Disabled` boolean — When origination settings are disabled, inbound calls are not enabled for your Amazon Chime SDK Voice Connector. This parameter is not required, but you must specify this parameter or <code>Routes</code>.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime-sdk-voice.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-voice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-voice/revisions/89ce97d6fad9/schema)