Delete an incoming phone number
Releases an Incoming Phone Number and removes it from the account. This is for numbers the account should no longer own; changing or deleting a handler does not release the number. Native phone-number resources use Release phone number.
To help prevent fraud and abuse, a number can’t be released during a hold period after purchase. For most Spaces the hold lasts 14 days, and up to 2 numbers can be released early each month while still on hold. Once those early releases are used, releasing a number that is still on hold returns 422 with error code 22121, and the message gives the date and time the hold ends.
Permissions
The API token used to authenticate must have the following scope(s) enabled to make a successful request: Numbers.
Authentication
SignalWire Basic Authentication using Project ID and API Token.
The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password.
Example:
Authorization: Basic base64(project_id:token)