Sign in
sessions.transcript

Get Session Transcript By Id

Return a session's transcript, and whether it is complete.

Transcript records reach the logs database through an asynchronous pipeline, so a read taken immediately after a session ends can return a short record. transcript_complete is true only when everything the session reported writing is present, across both the spoken transcript and the tool activity in actions. A caller that needs the whole record should re-request with exponential backoff until it is true, or until its own time limit passes, keeping the last response either way.

A time limit is required rather than optional. transcript_complete never turns true for a session still in progress, for a session on a channel that reports no expected count (only voice reports one today), or for a session that ended before the field was introduced - so a caller polling without a limit would never stop.

get/api/v1/sessions/transcript/{session_id}

Path parameters

session_idstring required

Response

Successful Response

session_idstring required

Internal ID of the session

transcript_completeboolean

True when every record the session reported writing is present, across both the spoken transcript and the tool activity in actions. False means the record cannot be confirmed complete. Callers should re-request until this is true, or until their own time limit passes. A limit is required rather than advisable, because three of the cases behind a False never turn true: a session still in progress, a session whose channel reports no expected count - only voice does today, so this is every web chat, SMS and email session - and any session that ended before this field was introduced.

Example response

{
  "transcription": [
    {
      "lang": "en-US",
      "source": "user"
    }
  ],
  "transcript_complete": true
}

Changes