POST
Preview Call Analysis

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

session_id
string<uuid>
required

Body

application/json

A spec to try, and the agent whose prompt it should be judged against.

agent_id is optional: without it the call's own recorded agent version supplies the system prompt, which is what you want when tuning a spec for an agent that already exists.

analysis
AnalysisSpec · object
required

What to work out about a call once it has ended.

One LLM call per session reads the finished transcript. Voice and video only.

agent_id
string<uuid> | null

Response

Successful Response

What the spec found. Nothing was written.

analysis
AnalysisResponse · object
required

The analysis of one call, as every reader sees it.

Shared verbatim by the calls API and the session.completed webhook so an integration that reads one can read the other.

model
string | null
provider
string | null