Skip to main content
POST
cURL
Runs all dispositions linked to the specified agent against a provided transcript and returns the grouped results. Useful for validating your disposition setup before going live. The response extracted_data is grouped by category and disposition name, in the same format as post-call execution data.

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string<uuid>
required

The agent whose dispositions will be evaluated.

Body

application/json

Transcript to evaluate against the agent's dispositions.

Request body for testing an agent's dispositions against a transcript.

transcript
string
required

The call transcript to run dispositions against.

Maximum string length: 50000
Example:

"Agent: Hi, how can I help you today? Customer: I am interested in your enterprise plan and would like to know more about pricing."

call_date
string<date-time>

Optional ISO 8601 date/datetime string for temporal context.

Example:

"2026-04-01T10:00:00Z"

Response

Grouped disposition results

Grouped disposition results in the same format as post-call execution data.

extracted_data
object

Results grouped by category and disposition name. Each leaf contains subjective (free-text) and/or objective (pre-defined value) fields.

Example: