Ingest Conversations
ingest_conversationsSubmit completed voice conversations to Okareo for monitoring. Each valid conversation becomes evaluable data points that trigger configured checks; invalid entries are returned for corrections.
Instructions
Submit completed voice conversations to Okareo for monitoring.
Each conversation's turns become evaluable data points and any
configured monitors run their checks automatically. Use this to feed
production voice traffic (Retell, Twilio, VAPI, ElevenLabs, or a custom
source) into Okareo monitoring.
Conversations are validated individually: valid ones are ingested and
invalid ones are returned in a "rejected" list — the batch is not
all-or-nothing.
Args:
conversations: List of conversation objects. Each MUST include a
"call_id" and at least one of: "transcript" (a list of
{role, content, timestamp_ms} turns), "audio"
({"type": "url"|"voice_file_id"|"inline_b64", ...}),
"recording_url", or "recording_bytes_b64". Optional per
conversation: "context_token", "metadata", "tags" (tags drive
monitor/filter-group matching), "diarization", "first_turn".
When both a transcript and audio are supplied, the transcript
takes precedence.
project_id: Okareo project ID. Defaults to the account's project.
mut_id: Optional model-under-test ID. Omit for pure monitoring —
data points are then matched to monitors by their tags only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mut_id | No | ||
| project_id | No | ||
| conversations | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |