Skip to main content
POST
/
v2
/
agent
/
{agent_id}
/
dispositions
/
test
cURL
curl --request POST \
  --url https://api.bolna.ai/v2/agent/{agent_id}/dispositions/test \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transcript": "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": "2026-04-01T10:00:00Z"
}
'
{
  "extracted_data": {
    "Lead Quality": {
      "Call Outcome": {
        "subjective": "Customer expressed strong interest and asked about enterprise pricing.",
        "objective": "interested"
      }
    },
    "Escalation": {
      "Agent Handover Needed": {
        "subjective": "",
        "objective": "No"
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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:
{
  "Lead Quality": {
    "Call Outcome": {
      "subjective": "Customer expressed strong interest and asked about enterprise pricing.",
      "objective": "interested"
    }
  },
  "Escalation": {
    "Agent Handover Needed": { "subjective": "", "objective": "No" }
  }
}