List Test Scenarios
curl --request GET \
--url https://api.bland.ai/v1/agent-testing/scenarios \
--header 'authorization: <authorization>'{
"scenarios": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Angry Caller Test",
"description": "Tests de-escalation handling",
"category": "ANGRY_CALLER",
"scenario_type": "AGENT",
"tester_persona_prompt": "You are a frustrated customer...",
"tester_persona_name": "Frustrated Customer",
"max_turns": 15,
"bland_tone_enabled": true,
"is_required_for_promotion": false,
"enabled": true,
"assertions": [
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"type": "LLM_JUDGE",
"name": "De-escalation",
"config": {
"prompt": "Did the agent successfully de-escalate the situation?",
"output_type": "score",
"threshold": 0.7
},
"is_required": true,
"weight": 1.5,
"order": 0
}
],
"most_recent_run": {
"id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
"status": "PASSED",
"score": 0.85,
"completed_at": "2026-04-13T18:30:00.000Z"
},
"created_at": "2026-04-10T12:00:00.000Z",
"updated_at": "2026-04-13T18:30:00.000Z"
},
{
"id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Happy Path - Booking",
"description": "Tests the standard booking flow",
"category": "HAPPY_PATH",
"scenario_type": "AGENT",
"tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
"tester_persona_name": "Polite Customer",
"max_turns": 20,
"bland_tone_enabled": false,
"is_required_for_promotion": true,
"enabled": true,
"assertions": [
{
"id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
"type": "NODE_REACHED",
"name": "Reached Booking Confirmation",
"config": {
"node_id": "booking-confirmation-node"
},
"is_required": true,
"weight": 1.0,
"order": 0
}
],
"most_recent_run": null,
"created_at": "2026-04-12T09:00:00.000Z",
"updated_at": "2026-04-12T09:00:00.000Z"
}
]
}
Agent Testing
List Test Scenarios
List all test scenarios for your organization.
GET
/
v1
/
agent-testing
/
scenarios
List Test Scenarios
curl --request GET \
--url https://api.bland.ai/v1/agent-testing/scenarios \
--header 'authorization: <authorization>'{
"scenarios": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Angry Caller Test",
"description": "Tests de-escalation handling",
"category": "ANGRY_CALLER",
"scenario_type": "AGENT",
"tester_persona_prompt": "You are a frustrated customer...",
"tester_persona_name": "Frustrated Customer",
"max_turns": 15,
"bland_tone_enabled": true,
"is_required_for_promotion": false,
"enabled": true,
"assertions": [
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"type": "LLM_JUDGE",
"name": "De-escalation",
"config": {
"prompt": "Did the agent successfully de-escalate the situation?",
"output_type": "score",
"threshold": 0.7
},
"is_required": true,
"weight": 1.5,
"order": 0
}
],
"most_recent_run": {
"id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
"status": "PASSED",
"score": 0.85,
"completed_at": "2026-04-13T18:30:00.000Z"
},
"created_at": "2026-04-10T12:00:00.000Z",
"updated_at": "2026-04-13T18:30:00.000Z"
},
{
"id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Happy Path - Booking",
"description": "Tests the standard booking flow",
"category": "HAPPY_PATH",
"scenario_type": "AGENT",
"tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
"tester_persona_name": "Polite Customer",
"max_turns": 20,
"bland_tone_enabled": false,
"is_required_for_promotion": true,
"enabled": true,
"assertions": [
{
"id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
"type": "NODE_REACHED",
"name": "Reached Booking Confirmation",
"config": {
"node_id": "booking-confirmation-node"
},
"is_required": true,
"weight": 1.0,
"order": 0
}
],
"most_recent_run": null,
"created_at": "2026-04-12T09:00:00.000Z",
"updated_at": "2026-04-12T09:00:00.000Z"
}
]
}
Documentation Index
Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
Use this file to discover all available pages before exploring further.
Headers
Your API key for authentication.
Query Parameters
Filter by pathway ID.
Filter by persona ID.
Filter by scenario category.
Filter by enabled status. Pass
"true" or "false".Response
Array of scenario objects, each including assertions and the most recent run.
Show scenario object
Show scenario object
Unique identifier for the scenario.
Organization ID that owns this scenario.
The pathway ID being tested (null if testing a persona).
The persona ID being tested (null if testing a pathway).
Name of the scenario.
Description of the scenario.
Scenario category.
Type of scenario.
Prompt for the simulated caller.
Display name for the tester persona.
Maximum conversation turns.
Whether Bland Tone scoring is enabled.
Whether this scenario is required for promotion.
Whether the scenario is enabled.
Array of assertion objects.
The most recent test run for this scenario (null if never run).
ISO 8601 timestamp of when the scenario was created.
ISO 8601 timestamp of when the scenario was last updated.
{
"scenarios": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Angry Caller Test",
"description": "Tests de-escalation handling",
"category": "ANGRY_CALLER",
"scenario_type": "AGENT",
"tester_persona_prompt": "You are a frustrated customer...",
"tester_persona_name": "Frustrated Customer",
"max_turns": 15,
"bland_tone_enabled": true,
"is_required_for_promotion": false,
"enabled": true,
"assertions": [
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"type": "LLM_JUDGE",
"name": "De-escalation",
"config": {
"prompt": "Did the agent successfully de-escalate the situation?",
"output_type": "score",
"threshold": 0.7
},
"is_required": true,
"weight": 1.5,
"order": 0
}
],
"most_recent_run": {
"id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
"status": "PASSED",
"score": 0.85,
"completed_at": "2026-04-13T18:30:00.000Z"
},
"created_at": "2026-04-10T12:00:00.000Z",
"updated_at": "2026-04-13T18:30:00.000Z"
},
{
"id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
"persona_id": null,
"name": "Happy Path - Booking",
"description": "Tests the standard booking flow",
"category": "HAPPY_PATH",
"scenario_type": "AGENT",
"tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
"tester_persona_name": "Polite Customer",
"max_turns": 20,
"bland_tone_enabled": false,
"is_required_for_promotion": true,
"enabled": true,
"assertions": [
{
"id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
"type": "NODE_REACHED",
"name": "Reached Booking Confirmation",
"config": {
"node_id": "booking-confirmation-node"
},
"is_required": true,
"weight": 1.0,
"order": 0
}
],
"most_recent_run": null,
"created_at": "2026-04-12T09:00:00.000Z",
"updated_at": "2026-04-12T09:00:00.000Z"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I