Release a phone number
Gives a number back for good: it stops answering at once and its rent ends.
Free
This tool costs nothing to call.
An example
The shop's line goes straight to the carrier again. Give back the Portland number.
Your agent callsphone_release_numberFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"number": "+15035550123"
}Use it when
A number is no longer wanted. The rest of the month is not refunded.
What it does
Give a number back. It stops answering at once, its rental ends and the number may go to someone else. This can't be undone, and the rest of the month is not refunded.
What comes back
released: the number. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
numberRequired | string | The number in E.164 form, e.g. +15035550123. Matches ^\+[1-9][0-9]{6,15}$. |
The call
Over MCP, call phone_release_number on https://api.conecto.chat/mcp/phone. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/phone_release_number \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"number":"+15035550123"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | The business rents no such number. | Call phone_list_numbers and use one of them. |
call_active409 | A call on the number is still going on. | Release it after the call has ended. |
carrier_unavailable503 | The carrier could not be reached; the number is still the business's. | Call again in a minute. |
phone_unavailable503 | The phone service is not switched on yet, or has no voices right now. | Try again later; nothing was charged. |
More Phone tools
All 8 tools- Find a phone number
phone_search_numbersPhone numbers the business can rent right now, each with the monthly price and a quote to rent it.Free* - Rent a phone number
phone_rent_numberRents a number found by phone_search_numbers; this call pays the first month.Quoted up to $25.00 - Set up how calls are answered
phone_setup_assistantSets how the business's numbers answer (the agent's webhook or taking messages), the greeting, voice and hours, and whether messages become tickets.$0.001 a call - Get how calls are answered
phone_get_assistantHow the business's numbers answer, whether they answer right now (and why not), and the voices to choose from.Free* - List phone numbers
phone_list_numbersThe numbers the business rents, with their monthly price and next renewal.Free* - List phone calls
phone_list_callsCalls to and from the business's numbers, newest first: who, when, how long and what it cost, missed ones included.Free* - Get a phone call
phone_get_callOne call with its whole transcript: who said what, and when.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md