---
title: "Changes to Run a simulation"
method: POST
path: "/v1/simulation/run"
---

# Changes to Run a simulation

`POST /v1/simulation/run`

> Every recorded change to this operation, newest first.
> 187 revisions in range; 1 not diffed.

## Timeline

Changed in 17 of 187 revisions.

- **2026-10-26** `5a00986bf78a`: 1 info
- **2026-10-09** `e7b6b5cc7fa6`: 2 breaking, 3 info
- **2026-10-02** `66e24fa671c0`: 4 info
- **2026-10-02** `e32b31fc8f98`: 1 info
- **2026-09-25** `c85d52a9f545`: 3 info
- **2026-09-24** `78165bfb14a9`: 1 info
- **2026-09-18** `55d2b83a248b`: 3 info
- **2026-09-17** `bc393c3f4164`: 4 info
- **2026-09-16** `3a3b54e58673`: 1 info
- **2026-09-16** `4b1b632cf357`: 1 warning, 2 info
- **2026-09-15** `38989bd64cb3`: 1 info
- **2026-09-09** `7ea77678cced`: 2 info
- **2026-09-08** `b4767c2011ae`: 5 info
- **2026-09-08** `02fdfe9e764a`: 1 info
- **2026-09-03** `6a09e09bd1ca`: 2 info
- **2026-08-20** `9080f2313118`: 1 warning
- **2026-08-17** `887b091b3d81`: 1 info

## Changes

- **2026-10-26** `5a00986bf78a`: 1 info
  - added `#/components/schemas/RunSimulationFromConfigKey` to the request body `oneOf` list
- **2026-10-09** `e7b6b5cc7fa6`: 2 breaking, 3 info
  - the `oneOf[subschema #1: New simulation]/plan/comparisonValues/items/` request property type changed from `string` to no type
  - the `oneOf[subschema #3: From template]/comparisonValues/items/` request property type changed from `string` to no type
  - added the new optional request property `oneOf[subschema #3: From template]/additionalMetrics`
  - added `#/components/schemas/ComparisonArm, subschema #1` to the `oneOf[subschema #1: New simulation]/plan/comparisonValues/items/` request property `anyOf` list
  - added `#/components/schemas/ComparisonArm, subschema #1` to the `oneOf[subschema #3: From template]/comparisonValues/items/` request property `anyOf` list
- **2026-10-02** `66e24fa671c0`: 4 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/maxNoResponseRetries`
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/noResponseRetryBackoffSeconds`
  - added the new optional request property `oneOf[subschema #3: From template]/maxNoResponseRetries`
  - added the new optional request property `oneOf[subschema #3: From template]/noResponseRetryBackoffSeconds`
- **2026-10-02** `e32b31fc8f98`: 1 info
  - the request property `oneOf[subschema #1: New simulation]/plan/metrics` became optional
- **2026-09-25** `c85d52a9f545`: 3 info
  - added the new optional request property `oneOf[subschema #3: From template]/environmentId`
  - added the new optional request property `oneOf[subschema #3: From template]/personaId`
  - added the new optional request property `oneOf[subschema #3: From template]/questions`
- **2026-09-24** `78165bfb14a9`: 1 info
  - the `iterationCount` request property default value `1` was removed
- **2026-09-18** `55d2b83a248b`: 3 info
  - added the new `INTERRUPTION` enum value to the request property `oneOf[subschema #1: New simulation]/plan/comparisonProperty`
  - added the new `INTERRUPTION` enum value to the request property `oneOf[subschema #1: New simulation]/plan/flows/items/overrides/items/property`
  - added the new `INTERRUPTION` enum value to the request property `oneOf[subschema #3: From template]/flows/items/overrides/items/property`
- **2026-09-17** `bc393c3f4164`: 4 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/flows/items/overrides`
  - added the new optional request property `oneOf[subschema #3: From template]/comparisonBaseline`
  - added the new optional request property `oneOf[subschema #3: From template]/comparisonValues`
  - added the new optional request property `oneOf[subschema #3: From template]/flows/items/overrides`
- **2026-09-16** `3a3b54e58673`: 1 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/comparisonValues`
- **2026-09-16** `4b1b632cf357`: 1 warning, 2 info
  - removed the request property `oneOf[subschema #1: New simulation]/plan/referenceCustomerFlowVariantId`
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/comparisonBaseline`
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/comparisonProperty`
- **2026-09-15** `38989bd64cb3`: 1 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/metrics/items/minPassRate`
- **2026-09-09** `7ea77678cced`: 2 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/includeAutomaticMetrics`
  - the `endCallReasons` request property default value `` was removed
- **2026-09-08** `b4767c2011ae`: 5 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/flows/items/edgeCases/anyOf[subschema #2]/items/slug`
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/flows/items/slug`
  - added `#/components/schemas/RunSimulationFromTemplate` to the request body `oneOf` list
  - the request property `oneOf[subschema #1: New simulation]/plan/flows/items/edgeCases/anyOf[subschema #2]/items/id` became optional
  - the request property `oneOf[subschema #1: New simulation]/plan/flows/items/id` became optional
- **2026-09-08** `02fdfe9e764a`: 1 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/includeFlowMetrics`
- **2026-09-03** `6a09e09bd1ca`: 2 info
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/enrichWithLiveConversation`
  - added the new optional request property `oneOf[subschema #1: New simulation]/plan/metrics/items/conversationSource`
- **2026-08-20** `9080f2313118`: 1 warning
  - added the new `PREPARING_CAPACITY` enum value to the `data/status` response property for the response status `200`
- **2026-08-17** `887b091b3d81`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/roarkhq/apis/roark-analytics-api/docs/v1/simulation/run/post.md) - [API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [Page](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/simulation/run/post)
