Skip to main content
The Analytics API gives you programmatic access to data about how your agent is performing. You can use it to query aggregate usage metrics, retrieve conversation transcripts, and run automated evaluations to assess conversation quality at scale.

​
Endpoints

EndpointDescription
Usage
POST Query usageQuery aggregate usage metrics for a project. Supports interactions, sessions, unique users, top intents, credit consumption, function usage, API calls, knowledge base documents, integrations, transcripts, and per-agent activity.
Transcript
POST Search transcriptsSearch for transcripts matching a set of filters. Supports filtering by date range, environment, session ID, custom properties, and evaluation results.
GET Get transcriptFetch a single transcript with its full conversation logs, properties, and evaluation results.
DELETE Delete transcriptPermanently remove a transcript along with its logs and all evaluation results.
POST End transcriptMark a transcript as complete. Triggers any enabled evaluations to run automatically.
Transcript property
GET Get all transcript propertiesList all custom property definitions for a project.
GET Get transcript propertyFetch the definition of a single transcript property.
POST Create transcript propertyDefine a new custom property for tagging transcripts in a project.
PATCH Update transcript propertyUpdate the name or type of an existing transcript property definition.
DELETE Delete transcript propertyRemove a property definition and its values from all transcripts in the project.
Transcript property value
GET Get all transcript property valuesRetrieve all property values set on a specific transcript.
POST Set transcript property valueAttach a value to a property on a specific transcript.
DELETE Delete transcript property valueRemove a single property value from a transcript without affecting the property definition.
Transcript evaluation
GET Get all evaluationsList all evaluation definitions for a project, including result counts per evaluation.
GET Get transcript evaluationFetch the definition of a single evaluation.
POST Create transcript evaluationDefine a new LLM-based evaluation. Supports boolean, numeric rating, free-text, and option types.
PATCH Update transcript evaluationUpdate the definition of an existing evaluation, including its prompt, model settings, and type-specific fields.
DELETE Delete transcript evaluationRemove an evaluation definition along with all its results across every transcript.
POST Run transcript evaluationRun a single evaluation against a specific transcript and return the result immediately.
POST Batch run transcript evaluationsQueue up to 10 evaluations across up to 100 transcripts in a single request.
POST Estimate transcript evaluationCalculate the expected cost of running evaluations against transcripts matching a set of filters before committing to a batch run.## Concepts

​
Transcripts

Transcripts are full records of each conversation. You can search, retrieve, and delete them, or mark them as ended. Ending a transcript signals that the conversation is complete and triggers any enabled evaluations to run automatically. Transcript properties are custom metadata fields you define at the project level and attach to individual transcripts. They’re useful for tagging conversations with context that isn’t captured automatically, such as a support ticket ID or a user segment. Once defined, you can filter transcript searches by property values.

​
Evaluations

Evaluations are automated, LLM-based quality assessments that run against your transcripts. You define an evaluation with a prompt describing what you’re measuring and an output type — a pass/fail boolean, a numeric rating, a free-text response, or a selection from a predefined set of options. Evaluations can run automatically whenever a transcript ends, or you can trigger them manually against individual transcripts or in batches.