> ## 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.

# Generate Scenario from Call

> Generate a test scenario from a historical call transcript using AI analysis.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body

**call\_id** `string` *required*

The ID of the historical call to generate a scenario from. The call transcript will be analyzed by AI to extract a realistic test scenario.

**pathway\_id** `string`

The pathway to bind the generated scenario to. Either `pathway_id` or `persona_id` is required.

**persona\_id** `string`

The persona to bind the generated scenario to. Either `pathway_id` or `persona_id` is required.

### Response

The response contains the generated scenario data. This data is **not yet saved** -- it is returned so you can review and use it to create a scenario.

> [!NOTE]
>
> Sensitive data such as phone numbers, webhook URLs, and API keys is automatically stripped from the generated `request_data`.

**name** `string`

An AI-generated name summarizing the scenario.

**description** `string`

An AI-generated description of what the scenario tests based on the call transcript.

**category** `string`

The inferred category for the scenario (e.g., `HAPPY_PATH`, `EDGE_CASE`, `ANGRY_CALLER`).

**tester\_persona\_prompt** `string`

An AI-generated prompt that instructs the simulated caller to replicate the behavior observed in the original call.

**tester\_persona\_name** `string`

A name for the simulated caller persona derived from the call.

**pathway\_id** `string`

The pathway the scenario is bound to (if provided).

**persona\_id** `string`

The persona the scenario is bound to (if provided).

**request\_data** `object`

Request data extracted from the call with sensitive fields automatically removed.

```json Response theme={null}
{
    "name": "Inbound Appointment Booking - Returning Customer",
    "description": "Simulates a returning customer calling to book a follow-up appointment. The caller provides their name and preferred time slot, and expects confirmation.",
    "category": "HAPPY_PATH",
    "tester_persona_prompt": "You are Sarah Chen, a returning customer. You previously visited for a consultation and want to book a follow-up appointment. You prefer afternoons, ideally next Thursday at 2 PM. Be polite but firm about your preferred time. If that slot is unavailable, accept an alternative within the same week.",
    "tester_persona_name": "Sarah Chen",
    "pathway_id": "pw_abc123",
    "persona_id": null,
    "request_data": {
        "customer_name": "Sarah Chen",
        "account_id": "cust_92841",
        "appointment_type": "follow_up"
    }
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.