Telephone Number

Delete telephone number on an account

Use to delete a telephone number on an account.<br/><br/> This is not possible if the telephone number has any outstanding activation events.<br/><br/> The phone number is placed in "cooldown" for the number of days specified in <a href="#/~schema/PartitionX">partition.tnDeleteCooldownDays</a>, after which it is returned the inbound carrier unless reclaimed to inventory first. Cooldown is intended to give the customer time to regret their decision and get their number back.<span hidden><br/><br/> See <a href="tnAccount.html#deleteTelephoneNumberOnAccount">here</a> for more information.</span>

delete/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}

Request

Path parameters

accountIdstring required

ID of account. Refers to <a href="#/~schema/TelephoneNumberAccountV2X">telephoneNumberAccount.accountId</a>, which refers to <a href="#/~schema/Account">account.id</a>

partitionIdstring required

ID of partition. Refers to <a href="#/~schema/TelephoneNumberAccountV2X">telephoneNumberAccount.partitionId</a>, which refers to <a href="#/~schema/PartitionX">partition.id</a>

tnstring required

Telephone number, 11 digits no spaces or dashes (include country code). Refers to <a href="#/~schema/TelephoneNumberAccountV2X">telephoneNumberAccount.phoneNumber</a>

Response

Telephone account successfully deleted

Changes

No recorded changes to this operation across all 1 revision of this API.