Recordings
Search Recordings
Semantic search over an end user’s transcript chunks
POST
Run a hybrid (semantic + keyword) search across an end user’s transcripts and get back the most relevant excerpts. Each result carries
start_ms/end_ms so you can deep-link a citation back to the moment in the audio. This is the retrieval primitive behind cross-recording AI Ask.
Authentication
Requires an API key withrecordings:read scope.
Request Body
string
required
Natural-language search query (1–1000 characters).
string
End user whose recordings to search (
eu_*). Required unless the API key is itself scoped to an end user.string[]
Restrict the search to these recordings. Omit to search all of the end user’s recordings.
string
Only include chunks from recordings on or after this time (ISO 8601).
string
Only include chunks from recordings before this time (ISO 8601).
integer
default:"8"
Maximum number of chunks to return (1–50).
Response
Returns the top-K most relevant transcript chunks, best first.Response Fields
Search only covers recordings that have a completed transcription — chunking + embedding runs automatically after transcription completes.

