---
title: "Create a simulation case"
method: POST
path: "/simulation_cases"
---

# Create a simulation case

`POST /simulation_cases`

Create a new simulation case for a workspace.

## Headers

- `Authorization` string, required

## Request body

- SimulationCaseCreateIn — Input payload to create a simulation case.
  - `name` string, required — Name of the simulation case.
  - `prompt` string, required — Prompt used during the simulation case.
  - `type` 'custom' | 'agent_based', required — Simulation case type.
  - `success_criteria` string[], required — Success criteria evaluated for the case.
  - `call_success_type` 'all' | 'any', required — Success logic for the case.
  - `suite_id` string, uuid — ID of the simulation suite to add this case to. Required for v2 simulation suites.
  - `base_agent_id` string, nullable — Agent ID to base the generated case on.

## Response `200`

200

- CreateSimulationCaseResponse200
  - `status` string — Whether the request was successful.
  - `response` SimulationCasesPostResponsesContentApplicationJsonSchemaResponse
    - `simulation_case` SimulationCaseReadOut — Simulation case details.
      - `simulation_case_id` string, uuid
      - `workspace_id` string
      - `suite_id` string, uuid, nullable — ID of the simulation suite this case belongs to.
      - `name` string
      - `prompt` string
      - `type` 'custom' | 'agent_based'
      - `success_criteria` string[]
      - `call_success_type` 'all' | 'any'
      - `base_agent` SimulationCaseReadOutBaseAgent
        - `model_id` string
        - `agent_name` string
        - `agent_type` string
        - `voice_engine_type` string
        - `phone_number` string, nullable
        - `updated_at` string, date-time
        - `image_url` string, nullable
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `400` — 400
- `422` — 422

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/6976456ad422/schema)