---
title: "Create a simulation scenario"
method: POST
path: "/simulation_scenarios"
---

# Create a simulation scenario

`POST /simulation_scenarios`

Create a new simulation scenario. Scenarios are templates used when generating test cases to ensure coverage of specific situations.

## Headers

- `Authorization` string, required

## Request body

- SimulationScenarioCreateIn
  - `name` string, required — Name of the simulation scenario template
  - `description` string, required — Description of what the scenario template should verify when generating test cases

## Response `200`

200

- CreateSimulationScenarioResponse200
  - `status` string — Whether the request was successful.
  - `response` SimulationScenarioReadOut
    - `id` string, uuid — Unique identifier for the simulation scenario
    - `name` string — Name of the simulation scenario template
    - `description` string — Description of what the scenario template should verify when generating test cases
    - `workspace_id` string — Workspace ID this simulation scenario belongs to
    - `created_at` string, date-time — When the simulation scenario was created
    - `updated_at` string, date-time — When the simulation scenario was last updated

## Other responses

- `400` — 400

---

[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)