---
title: "PUT /voice-connector-groups/{voiceConnectorGroupId}"
method: PUT
path: "/voice-connector-groups/{voiceConnectorGroupId}"
---

# PUT /voice-connector-groups/{voiceConnectorGroupId}

`PUT /voice-connector-groups/{voiceConnectorGroupId}`

Updates the settings for the specified Amazon Chime SDK Voice Connector group.

## Path parameters

- `voiceConnectorGroupId` string, required

## Request body

- object
  - `Name` string, required — The name of the Voice Connector group.
  - `VoiceConnectorItems` VoiceConnectorItem[], required — The <code>VoiceConnectorItems</code> to associate with the Voice Connector group.
    - `VoiceConnectorId` string, required — The Voice Connector ID.
    - `Priority` integer, required — The priority setting of a Voice Connector item. Calls are routed to hosts in priority order, with 1 as the highest priority. When hosts have equal priority, the system distributes calls among them based on their relative weight.

## Response `202`

Success

- UpdateVoiceConnectorGroupResponse
  - `VoiceConnectorGroup` object — The updated Voice Connector group.
    - `VoiceConnectorGroupId` string — The ID of a Voice Connector group.
    - `Name` string — The name of a Voice Connector group.
    - `VoiceConnectorItems` VoiceConnectorItem[] — The Voice Connectors to which you route inbound calls.
      - `VoiceConnectorId` string, required — The Voice Connector ID.
      - `Priority` integer, required — The priority setting of a Voice Connector item. Calls are routed to hosts in priority order, with 1 as the highest priority. When hosts have equal priority, the system distributes calls among them based on their relative weight.
    - `CreatedTimestamp` string, date-time — The Voice Connector group's creation time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The Voice Connector group's creation time stamp, in ISO 8601 format.
    - `VoiceConnectorGroupArn` string — The ARN of the Voice Connector group.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ConflictException
- `485` — ThrottledClientException
- `486` — ServiceUnavailableException
- `487` — 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/versions/89ce97d6fad9/schema)