---
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 or calling names. You can update one attribute at a time for each `UpdatePhoneNumberRequestItem`. For example, you can update the product type or the calling name.

For toll-free numbers, you cannot use the Amazon Chime Business Calling product type. For numbers outside the U.S., you must use the Amazon Chime SIP Media Application Dial-In product type.

Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.

## Query parameters

- `operation` 'batch-update', required

## Request body

- object
  - `UpdatePhoneNumberRequestItems` UpdatePhoneNumberRequestItem[], required — The request containing the phone number IDs and product types or calling names to update.
    - `PhoneNumberId` string, required — The phone number ID to update.
    - `ProductType` 'BusinessCalling' | 'VoiceConnector' | 'SipMediaApplicationDialIn' — The product type to update.
    - `CallingName` string, password — The outbound calling name to update.

## Response `200`

Success

- BatchUpdatePhoneNumberResponse
  - `PhoneNumberErrors` PhoneNumberError[] — If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
    - `PhoneNumberId` string — 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' — 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.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)