Tone docs
API referencesip-trunks

Delete a trunk

Refused with 409 sip_trunk_has_numbers while imported numbers still ride it — release them first. Live calls on the trunk are hung up.

Open in ClaudeOpen in ChatGPTView as Markdown

Requires the admin scope. A key with less gets 403 insufficient_scope.

DELETE
/v1/sip-trunks/{id}

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The SIP trunk's id.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/sip-trunks/string"
{  "data": null}
Was this page helpful?

The numbers imported onto this trunk

Live numbers only — released ones are history.

Issue a new digest password — shown once

🔴 The previous password stops working within seconds. Update your PBX first if it registers, then rotate. The new password appears in this response only.