Legs

Challenge a ringing inbound SIP leg with a 401 digest auth request

Sends a SIP 401 Unauthorized carrying a WWW-Authenticate digest challenge on an unanswered inbound INVITE. The current leg is torn down (a leg.disconnected with reason="challenged" is published); the UAC's credentialed re-INVITE arrives as a new inbound call surfaced via leg.ringing with authenticated=true once VoiceBlender verifies the response against the supplied credential. Provide either password or ha1. An invalid retry is answered with 403 Forbidden and never surfaced.

post/legs/{id}/challenge

Request body

realmstring required

usernamestring

passwordstring

ha1string

algorithmstring

qopstring[]

max_expiresinteger

Response

401 challenge queued

Changes

Changed in 3 of the 67 revisions of this API.12

Jul 8, 2026dd81a8d77dba1See the full diff
- ○
  added the new optional request property max_expires
  new-optional-request-property
Jul 4, 20268e2966a803c81See the full diff
- ○
  endpoint added
  endpoint-added
Mar 26, 2026d09c97c6ca8c1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history