---
title: "DELETE /phone-number/{PhoneNumberId}"
method: DELETE
path: "/phone-number/{PhoneNumberId}"
---

# DELETE /phone-number/{PhoneNumberId}

`DELETE /phone-number/{PhoneNumberId}`

Releases a phone number previously claimed to an Amazon Connect instance or traffic distribution group. You can call this API only in the Amazon Web Services Region where the number was claimed.

To release phone numbers from a traffic distribution group, use the `ReleasePhoneNumber` API, not the Amazon Connect console.

After releasing a phone number, the phone number enters into a cooldown period of 30 days. It cannot be searched for or claimed again until the period has ended. If you accidentally release a phone number, contact Amazon Web Services Support.

## Path parameters

- `PhoneNumberId` string, required

## Query parameters

- `clientToken` string

## Response `200`

Success

## Other responses

- `480` — InvalidParameterException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — InternalServiceException
- `484` — ResourceInUseException
- `485` — IdempotencyException
- `486` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/connect.md) · [All operations](https://skmtc.net/aws/apis/connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/connect/versions/fbcf0a4faed2/schema)