Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
sessions

Fetch the canonical analysis input for a completed session

Returns the SessionAnalysisInput shape defined in src/knowledge_gap/analysis_schemas.py.

  • 404 — session not found, or owned by a different organization.
  • 409 — session is not in a terminal state (still active / paused / waiting for human / etc.). The analyzer should only be run on completed sessions.
get/v1/sessions/{session_id}/analysis-input

Path parameters

session_idstring uuid required

Response

Successful Response

analyzer_input_schema_versioninteger
session_idstring uuid required
organization_idstring uuid required
agent_idstring uuid nullable required
channelstring required
started_atstring date-time required
ended_atstring date-time nullable required
completion_reasonstring nullable required
knowledge_gap_analysis_outcome'resolved' | 'unresolved' | 'transferred' | 'expired' | 'error' | 'abandoned' | 'voicemail' | 'escalated' | 'call_failed' required

Canonical, analyzer-friendly outcome of a completed session.

Derived from (SessionStatus, SessionTerminationReason) at close time and persisted on ConvSessionMeta.knowledge_gap_analysis_outcome. Free-form termination_reason is preserved alongside for forensic detail.

customer_metadataobject nullable
missing_evidence_reasonsMissingEvidenceReason[]