Release a number
release_numberPermanently release a phone number after explicit user authorization.
A mismatched ``confirm_e164`` returns an error without releasing anything.
Calls and texts to a released number stop. Recovery is not guaranteed.
Current and previous monthly fees remain due, without a refund.
Pending orders cannot be released and return 409.
A failed order was not purchased; this operation only dismisses it from the list.
Returns ``released`` or ``dismissed``, plus ``number_id`` and ``e164``, or an error.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"number_id": "<number_id>",
"confirm_e164": "<confirm_e164>"
},
"name": "release_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| number_id | Yes | Workspace phone number ID, from ``list_numbers`` or ``acquire_number``. | |
| confirm_e164 | Yes | The number's ``e164`` value, such as ``+14155551234``, as a safety check. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||