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.
Requires the write scope. A key with less gets 403 insufficient_scope.
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
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/test"{ "data": { "at": "2026-09-10T08:12:44Z", "error": null, "latencyMs": 41, "method": "options", "ok": true, "sipStatus": 200 }}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.
Change a trunk's configuration
Send null to clear a field; omit the key to leave it alone. Changes reach the gateway within seconds. Status is not settable here — approval is ours, and disabling is a support action.