curl -X DELETE "https://api.telzino.com/v1/organizations/234cd323-…/sms-numbers/%2B13234137301" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "data": { "phone_number": "+13234137301" } }
{
"error": "number_in_use",
"error_description": "That number is in use. Take it off these agents first.",
"in_use_by": [
{ "type": "conversation_channel", "agent_id": "9f1c…", "agent_name": "Front Desk" },
{ "type": "send_hosted_sms", "agent_id": "71f7…", "agent_name": "Sales" }
]
}
Organizations
Remove an SMS Number
Take a hosted SMS number off an organization
DELETE
/
v1
/
organizations
/
{organization_id}
/
sms-numbers
/
{number}
curl -X DELETE "https://api.telzino.com/v1/organizations/234cd323-…/sms-numbers/%2B13234137301" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "data": { "phone_number": "+13234137301" } }
{
"error": "number_in_use",
"error_description": "That number is in use. Take it off these agents first.",
"in_use_by": [
{ "type": "conversation_channel", "agent_id": "9f1c…", "agent_name": "Front Desk" },
{ "type": "send_hosted_sms", "agent_id": "71f7…", "agent_name": "Sales" }
]
}
This call needs a partner-level API key. It is refused while an agent uses the number, through a conversation channel or a Send Hosted SMS function. Take the number off those agents first, then remove it.
Path Parameters
The E.164 number. Its leading
+ is not safe in a URL path, so send it percent-encoded (%2B13234137301).curl -X DELETE "https://api.telzino.com/v1/organizations/234cd323-…/sms-numbers/%2B13234137301" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "data": { "phone_number": "+13234137301" } }
{
"error": "number_in_use",
"error_description": "That number is in use. Take it off these agents first.",
"in_use_by": [
{ "type": "conversation_channel", "agent_id": "9f1c…", "agent_name": "Front Desk" },
{ "type": "send_hosted_sms", "agent_id": "71f7…", "agent_name": "Sales" }
]
}
| Code | Meaning |
|---|---|
200 | Removed |
400 | The number is not valid E.164 |
403 | The API key is not partner-level |
404 | Organization not found, or the number is not on this organization |
409 | The number is in use (number_in_use). in_use_by lists what uses it. |
