---
title: "Create Simulation"
method: POST
path: "/eval/simulation"
tags: ["Simulations"]
---

# Create Simulation

`POST /eval/simulation`

## Request body

- CreateSimulationDTO
  - `name` string — This is an optional friendly name for the simulation.
  - `scenarioId` string, uuid, required — This is the ID of the scenario to use for this simulation.
  - `personalityId` string, uuid, required — This is the ID of the personality to use for this simulation.
  - `path` string, nullable — Optional folder path for organizing simulations. Supports up to 3 levels (e.g., "dept/feature/variant"). Maps to GitOps resource folder structure.

## Response `201`

- Simulation
  - `id` string, uuid, required — This is the unique identifier for the simulation.
  - `orgId` string, uuid, required — This is the unique identifier for the organization this simulation belongs to.
  - `createdAt` string, date-time, required — This is the ISO 8601 date-time string of when the simulation was created.
  - `updatedAt` string, date-time, required — This is the ISO 8601 date-time string of when the simulation was last updated.
  - `name` string — This is an optional friendly name for the simulation.
  - `scenarioId` string, uuid, required — This is the ID of the scenario to use for this simulation.
  - `personalityId` string, uuid, required — This is the ID of the personality to use for this simulation.
  - `path` string, nullable — Optional folder path for organizing simulations. Supports up to 3 levels (e.g., "dept/feature/variant"). Maps to GitOps resource folder structure.

## Changes

> 57 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/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/872ff45af53b/schema)