---
title: "POST /phone-numbers#operation=batch-update"
method: POST
path: "/phone-numbers#operation=batch-update"
---

# POST /phone-numbers#operation=batch-update

`POST /phone-numbers#operation=batch-update`

Updates phone number product types, calling names, or phone number names. You can update one attribute at a time for each `UpdatePhoneNumberRequestItem`. For example, you can update the product type, the calling name, or phone name.

You cannot have a duplicate `phoneNumberId` in a request.

## Query parameters

- `operation` 'batch-update', required

## Request body

- object
  - `UpdatePhoneNumberRequestItems` UpdatePhoneNumberRequestItem[], required — Lists the phone numbers in the update request.
    - `PhoneNumberId` string, password, required — The phone number ID to update.
    - `ProductType` 'VoiceConnector' | 'SipMediaApplicationDialIn' — The product type to update.
    - `CallingName` string, password — The outbound calling name to update.
    - `Name` string, password — The name of the phone number.

## Response `200`

Success

- BatchUpdatePhoneNumberResponse
  - `PhoneNumberErrors` PhoneNumberError[] — A list of failed phone numbers and their error messages.
    - `PhoneNumberId` string, password — The phone number ID for which the action failed.
    - `ErrorCode` 'BadRequest' | 'Conflict' | 'Forbidden' | 'NotFound' | 'PreconditionFailed' | 'ResourceLimitExceeded' | 'ServiceFailure' | 'AccessDenied' | 'ServiceUnavailable' | 'Throttled' | 'Throttling' | 'Unauthorized' | 'Unprocessable' | 'VoiceConnectorGroupAssociationsExist' | 'PhoneNumberAssociationsExist' | 'Gone' — The error code.
    - `ErrorMessage` string — The error message.

## 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)