VEverdun
voice-sessions

Stop Talk Session

Stop a session. Idempotent: a client that both closes the socket and sends this is doing the right thing twice, not making an error.

delete/speakers/talk-sessions/{session_id}

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/speakers/talk-sessions/{session_id}
  • Auth
    HTTP bearer

Path parameters

session_idstring required

Response

Successful Response

session_idstring uuid required

The session that was stopped, or was already stopped.

ended_atstring date-time nullable

When the session closed. Null while a stop is still in progress - the row is only stamped once the device stream is actually shut.

end_reasonstring nullable

Why it stopped. Exhaustive set - see VoiceSessionEndReason.

duration_msinteger nullable

Time the stream was live.

bytes_sentinteger

Bytes accepted by the device socket. NOT a delivery confirmation: transmit.cgi answers only at stream end, so no mid-stream acknowledgement exists to verify.

Example response

{
  "end_reason": "ended_by_operator"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.