Conversation

A conversation record — metadata and lifecycle, without its transcript.

conversation_id
Type: string · Conversation Id
required

Stable identifier for the conversation.
medium
Type: string · Medium
required

Communication medium, e.g. voice.
status
Type: string · Status
required

open while a session is live; closed once the last session ends.
configuration_ids
Type: array string[] · Configuration Ids

Distinct configuration ids active over the conversation.
created_at
Type: string · Created Atnullable
ended_at
Type: string · Ended Atnullable

When the last session ended (ISO 8601); absent while open.
source_sessions
Type: array string[] · Source Sessions

Session ids that produced turns.
started_at
Type: string · Started Atnullable

When the earliest session started (ISO 8601).
transport_key
Type: string · Transport Keynullable

Medium-native key: the telephony call_id for voice.
turn_count
Type: integer · Turn Count

Total turns written to the transcript.
updated_at
Type: string · Updated Atnullable
usage
Type: object · ConversationUsage
- audio_seconds
  Type: number · Audio Seconds
- operator_results_emitted
  Type: integer · Operator Results Emitted
  
  Integer numbers.
user_id
Type: string · User Idnullable

End-user identifier, if supplied.