Run Speaker Sip Test
Place a REAL AI call on this speaker to prove the SIP path works.
SITE-ADMIN ONLY, like the rest of this router and for the same reason: it hands out real-world sound at a customer site. During an install it is often an ESCALATE_VOICE_DOWN operator on the phone with the technician — widening it to them was considered and declined (round-0 review, OQ-5), and that refusal is unchanged: the 2026-09-15 widening admitted the monitoring manager, who runs the floor, not the operator on the call.
IT ANNOUNCES NOTHING AND CANNOT. The call row has no reservation, so the only writer of announced_at has nothing to write on; the provider webhook drops the call as not-a-talk-down; and the test agent is published with no custom functions, so it cannot escalate, dismiss, or record an outcome.
503 until RETELL_SIPTEST_AGENT_ID is set (or when it equals the talk-down agent's id). 409 for a speaker tested inside the last minute, for a site that has used its daily allowance, and for a horn somebody else is already talking on. A DEVICE REFUSAL IS A 200, NOT A 502: the device's own error body ("Invalid SIPAccountId 'Gate horn'") is the answer the owner pressed the button for, so it comes back in device_error with passed: false rather than as an error carrying nothing. A 502 here means the device could not be reached at all.
A 200 MEANS THE HORN IS ON A CALL RIGHT NOW, not that the test is over: the route returns at connect so the owner hears it, and the watchdog hangs it up at the cap. Poll the GET below to watch it end.
Request
- Base URLhttps://api.verdun.ai (the document declares no server; this is the origin it was published from)
- URLhttps://api.verdun.ai/speakers/{speaker_id}/sip-test
- AuthHTTP bearer
Path parameters
Response
Successful Response
Example response
{
"speaker_label": "North horn — gate",
"status": "connected",
"device_call_id": "1",
"device_states": [
{
"state": "Calling"
}
],
"provider_call_id": "call_85b9",
"provider_status": "ongoing",
"provider_disconnection_reason": "agent_hangup",
"duration_ms": 13400,
"auth_mode": "digest",
"device_error": {
"http_status": 400,
"body": "{\"error\":{\"code\":400,\"message\":\"Invalid SIPAccountId 'Gate horn'\"}}"
},
"sip_account_id": "sip_account_1",
"end_reason": "max_duration",
"max_seconds": 30,
"result_version": 1
}Changes
No recorded changes to this operation across all 2 revisions of this API.