API ReferenceTelephony Configs & Numbers
Delete a phone number
DELETE /api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id} — remove a DID from a config.
DELETE /api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id}Removes a phone number from the configuration. Inbound calls to it stop resolving to any agent.
Response
200 OK:
{ "message": "Phone number deleted" }Examples
curl -X DELETE https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/7/phone-numbers/88 \
-H "X-API-Key: zsk_..."import httpx
httpx.delete(
"https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/7/phone-numbers/88",
headers={"X-API-Key": "zsk_..."},
)Errors
| Status | detail | When |
|---|---|---|
404 | "Telephony configuration not found" | config_id not in your org. |
404 | "Phone number not found" | phone_number_id not under this config. |
Related
Update a phone number
PUT /api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id} — swap or clear the inbound agent, toggle active, re-sync the provider.
Tata Smartflo setup
Agent routing on Tata Smartflo — streaming-native specifics, API-first inbound bindings with server-resolved credentials, and saved-agent attachments.