POST/live/sessions/{session_id}/hangup

Hang up a Live session

Ends a SIP call associated with a Live session by submitting a hangup request. Use the opaque session_id returned when the session was created or supplied in an incoming-call webhook, preserving its prefix and value unchanged. A 200 response confirms that the hangup request was accepted.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
session_idstringrequired
Opaque Live session identifier from the creation response or an incoming-call webhook. Preserve the returned value unchanged, including its prefix.

2 status codes
200Returns confirmation that the session hangup request was accepted.
404Returned when the session or call was not found or is unavailable for this operation.
errorobjectrequired

Error handling

A 404 is returned when the session or call cannot be found or is unavailable for this operation. The session_id path parameter must be the unchanged opaque identifier from the session creation response or incoming-call webhook.