Skip to main content

​
POST /v2/agent/{agent_id}/dispositions/test

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.

​
Path Parameters

ParameterTypeRequiredDescription
agent_idUUIDYesThe agent whose dispositions will be evaluated

​
Request Body

FieldTypeRequiredDescription
transcriptstringYesThe call transcript to run dispositions against (max 50,000 characters)
call_datestringNoOptional ISO 8601 date/datetime string for temporal context (e.g. "2026-04-01T10:00:00Z")

​
Response

200 OK Returns extracted_data — results grouped by category and disposition name, in the same format as post-call execution data: 
{
  "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"
      }
    }
  }
}

​
Example

curl --request POST \
  --url 'https://api.bolna.dev/v2/agent/{agent_id}/dispositions/test' \
  --header 'Authorization: Bearer {api_key}' \
  --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"
  }'

​
Error Responses

StatusDescription
403Access denied — agent does not belong to your account
404Invalid or unknown agent_id
500Internal server error