---
title: "Generate Scenarios with AI"
method: POST
path: "/eval/simulation/scenario/generate"
tags: ["Simulations"]
---

# Generate Scenarios with AI

`POST /eval/simulation/scenario/generate`

Uses AI to analyze an assistant or squad configuration and generate test scenarios

## Request body

- GenerateScenariosDTO
  - `assistantId` string — ID of the assistant to generate scenarios for
  - `squadId` string — ID of the squad to generate scenarios for

## Response `201`

- GenerateScenariosResponse
  - `scenarios` GeneratedScenario[], required — Generated scenarios
    - `name` string, required — Short descriptive name
    - `instructions` string, required — Instructions for the tester
    - `category` 'happy_path' | 'edge_case' | 'failure_mode', required — Scenario category
    - `reasoning` string, required — Why this scenario is valuable
  - `coverageNotes` string, required — Summary of test coverage

## Changes

> 55 revisions in range; 2 not diffed, 9 could not be searched.

- **2026-08-19** `74c487628c18` — 2 warning
  - deleted the `header` request parameter `x-client-source`
  - deleted the `header` request parameter `x-simulation-entry-point`
  - …this revision’s changelog is incomplete

[Change history](https://skmtc.dev/vapiai/apis/vapi-api/changes/eval/simulation/scenario/generate/post.md)

---

[API](https://skmtc.dev/vapiai/apis/vapi-api.md) · [All operations](https://skmtc.dev/vapiai/apis/vapi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vapiai/vapi-api/revisions/74c487628c18/schema)