Release phone number
Releases a project-owned phone number by ID, removing it from the project. Use it only when the number should no longer be owned; deleting a handler resource or removing its E911 assignment does not release the number. Compatibility Incoming Phone Numbers use their own delete operation.
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. The error’s detail 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)