Tone docs
API referencesip-trunks

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.

Open in ClaudeOpen in ChatGPTView as Markdown

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

POST
/v1/sip-trunks/{id}/credentials/rotate

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 POST "https://example.com/v1/sip-trunks/string/credentials/rotate"
{  "data": {    "connection": {      "host": "sip.usetone.ai",      "ips": [        "13.233.10.20"      ],      "password": "Qm9vZ2llV29vZ2llMTIzNDU2",      "port": 5061,      "realm": "sip.usetone.ai",      "transport": "tls",      "username": "t_9f2c4a7b1d3e5f60"    },    "trunk": {      "allowOrigination": false,      "approvedAt": "2026-09-09T11:00:00Z",      "callerIdPolicy": "did",      "codecs": [        "PCMA",        "PCMU"      ],      "connection": {        "host": "sip.usetone.ai",        "ips": [          "13.233.10.20"        ],        "port": 5061,        "transport": "tls"      },      "createdAt": "2026-09-09T10:14:22Z",      "customHeaders": {},      "digestUsername": "t_9f2c4a7b1d3e5f60",      "disabledReason": null,      "hasOutboundPassword": true,      "id": "4b7c1a02-9de5-4f31-bb07-2c1a5e9f0d43",      "inboundAuth": "digest",      "ipAcl": [        "49.207.12.0/24"      ],      "lastInboundAt": "2026-09-10T08:12:44Z",      "lastOutboundAt": null,      "lastProbe": {        "at": "2026-09-10T08:12:44Z",        "error": null,        "latencyMs": 41,        "method": "options",        "ok": true,        "sipStatus": 200      },      "maxConcurrent": 10,      "name": "Airtel SIP — Mumbai office",      "outboundAuthUsername": "acme-out",      "outboundHost": "sbc.acme-telecom.example",      "outboundNumberFormat": "e164",      "outboundPort": 5061,      "outboundTransport": "tls",      "realm": "sip.usetone.ai",      "register": false,      "status": "active",      "updatedAt": "2026-09-10T08:12:44Z"    }  }}
Was this page helpful?

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.

Test connectivity to your carrier

The gateway sends a SIP OPTIONS (or a REGISTER, for registering trunks) to outboundHost and reports what came back. Stored as lastProbe on the trunk. 503 provider_unavailable if the gateway itself cannot be reached.