Skip to main content

​
Assets start in your system

Ingest requests carry your asset_id, so search results can join back to your database, CRM, support ticket, observability platform, or call log without ID translation. 
await client.ingest({
  source: "url",
  asset_id: "call_8294",
  asset_class: "customer_acme",
  url: "https://storage.example.com/calls/8294.mp3",
});

​
Asset classes define search scope

asset_class is how you draw the boundary around what gets searched together. For most products, it maps to the entity your customers think in terms of:
  • one end customer
  • one workspace
  • one project
  • one support queue
If you’re building customer-facing search, scope by asset_class or explicit asset_ids. Global search (scope: "all") searches across your indexed assets.

​
Indexing surface types

types controls what gets indexed and searched.
TypeUse when
audioSpeaker identity, acoustic events, sound-level patterns.
videoOn-screen content, visual context, screen recordings.
transcriptSpoken words, topic retrieval, semantic search over dialogue.
Most voice AI use cases want all three: 
types: ["audio", "video", "transcript"]

​
Indexing is async

Ingest returns a task_id immediately. The actual indexing happens in the background. Poll until ready or failed. 
const { task_id } = await client.ingest(request);
const task = await client.pollTask(task_id);

if (task.status === "failed") {
  throw new Error(task.error ?? "indexing failed");
}
Task states: pending → indexing → ready (or failed).

​
Search returns timestamped matches

Results include start_ms and end_ms: millisecond offsets into the source recording. 
{
  "asset_id": "call_8294",
  "score": 0.87,
  "start_ms": 42000,
  "end_ms": 58000,
  "match_type": "transcript"
}
threshold controls how strict the match has to be. Default is 0.5. Raise it to get fewer, higher-confidence results.

​
Your data stays yours

The API returns: asset_id, asset_class, types, scores, and timestamps. Provider IDs, index keys, and pipeline details stay behind the API.

TypeScript SDK

Inputs, outputs, and error types for the TypeScript client.