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

# Changes to Create a run plan

`POST /v1/simulation/plan`

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

## Timeline

Changed in 16 of 187 revisions.

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

## Changes

- **2026-10-26** `1e3d72699f2a`: 3 info
  - added the new optional request property `oneOf[subschema #1: New plan]/notifications`
  - added the new optional request property `oneOf[subschema #2: From template]/notifications`
  - added the required property `data/runPlan/notifications` to the response with the `201` status
- **2026-10-09** `e7b6b5cc7fa6`: 1 breaking, 24 warning, 2 info
  - the request's body type changed from `object` to no type
  - removed the request property `agentEndpoints`
  - removed the request property `autoRun`
  - removed the request property `comparisonBaseline`
  - removed the request property `comparisonProperty`
  - removed the request property `comparisonValues`
  - removed the request property `description`
  - removed the request property `direction`
  - removed the request property `endCallPhrases`
  - removed the request property `endCallReasons`
  - removed the request property `enrichWithLiveConversation`
  - removed the request property `executionMode`
  - removed the request property `flows`
  - removed the request property `includeAutomaticMetrics`
  - removed the request property `includeFlowMetrics`
  - removed the request property `iterationCount`
  - removed the request property `maxConcurrentJobs`
  - removed the request property `maxNoResponseRetries`
  - removed the request property `maxSimulationDurationSeconds`
  - removed the request property `metrics`
  - removed the request property `name`
  - removed the request property `noResponseRetryBackoffSeconds`
  - removed the request property `personas`
  - removed the request property `scenarios`
  - removed the request property `silenceTimeoutSeconds`
  - added `#/components/schemas/CreateRunPlanFromConfig, #/components/schemas/CreateRunPlanFromTemplate` to the request body `oneOf` list
  - added the required property `data/runPlan/template` to the response with the `201` status
- **2026-10-02** `66e24fa671c0`: 4 info
  - added the new optional request property `maxNoResponseRetries`
  - added the new optional request property `noResponseRetryBackoffSeconds`
  - added the required property `data/runPlan/maxNoResponseRetries` to the response with the `201` status
  - added the required property `data/runPlan/noResponseRetryBackoffSeconds` to the response with the `201` status
- **2026-10-02** `e32b31fc8f98`: 1 info
  - the request property `metrics` became optional
- **2026-09-18** `55d2b83a248b`: 2 warning, 2 info
  - added the new `INTERRUPTION` enum value to the `data/runPlan/comparisonProperty` response property for the response status `201`
  - added the new `INTERRUPTION` enum value to the `data/runPlan/flows/items/overrides/items/property` response property for the response status `201`
  - added the new `INTERRUPTION` enum value to the request property `comparisonProperty`
  - added the new `INTERRUPTION` enum value to the request property `flows/items/overrides/items/property`
- **2026-09-17** `bc393c3f4164`: 2 info
  - added the new optional request property `flows/items/overrides`
  - added the optional property `data/runPlan/flows/items/overrides` to the response with the `201` status
- **2026-09-16** `3a3b54e58673`: 1 info
  - added the new optional request property `comparisonValues`
- **2026-09-16** `4b1b632cf357`: 1 breaking, 1 warning, 4 info
  - removed the required property `data/runPlan/referenceCustomerFlowVariantId` from the response with the `201` status
  - removed the request property `referenceCustomerFlowVariantId`
  - added the new optional request property `comparisonBaseline`
  - added the new optional request property `comparisonProperty`
  - added the required property `data/runPlan/comparisonBaseline` to the response with the `201` status
  - added the required property `data/runPlan/comparisonProperty` to the response with the `201` status
- **2026-09-15** `38989bd64cb3`: 2 info
  - added the new optional request property `metrics/items/minPassRate`
  - added the required property `data/runPlan/metrics/items/minPassRate` to the response with the `201` status
- **2026-09-09** `7ea77678cced`: 3 info
  - added the new optional request property `includeAutomaticMetrics`
  - added the required property `data/runPlan/includeAutomaticMetrics` to the response with the `201` status
  - added the required property `data/runPlan/isConfigManaged` to the response with the `201` status
- **2026-09-08** `b4767c2011ae`: 2 breaking, 6 info
  - the response property `data/runPlan/flows/items/edgeCases/anyOf[subschema #2]/items/id` became optional for the status `201`
  - the response property `data/runPlan/flows/items/id` became optional for the status `201`
  - added the new optional request property `flows/items/edgeCases/anyOf[subschema #2]/items/slug`
  - added the new optional request property `flows/items/slug`
  - the request property `flows/items/edgeCases/anyOf[subschema #2]/items/id` became optional
  - the request property `flows/items/id` became optional
  - added the optional property `data/runPlan/flows/items/edgeCases/anyOf[subschema #2]/items/slug` to the response with the `201` status
  - added the optional property `data/runPlan/flows/items/slug` to the response with the `201` status
- **2026-09-08** `02fdfe9e764a`: 2 info
  - added the new optional request property `includeFlowMetrics`
  - added the required property `data/runPlan/includeFlowMetrics` to the response with the `201` status
- **2026-09-03** `6a09e09bd1ca`: 4 info
  - added the new optional request property `enrichWithLiveConversation`
  - added the new optional request property `metrics/items/conversationSource`
  - added the required property `data/runPlan/enrichWithLiveConversation` to the response with the `201` status
  - added the required property `data/runPlan/metrics/items/conversationSource` to the response with the `201` status
- **2026-08-20** `9080f2313118`: 1 warning
  - added the new `PREPARING_CAPACITY` enum value to the `data/runPlanJob/oneOf[#/components/schemas/RunSimulationPlanResponse]/status` response property for the response status `201`
- **2026-08-17** `887b091b3d81`: 11 warning, 10 info
  - the `iterationCount` request property's max was set to `10000.00`
  - added the new `conflict` enum value to the `type` response property for the response status `400`
  - added the new `conflict` enum value to the `type` response property for the response status `401`
  - added the new `conflict` enum value to the `type` response property for the response status `403`
  - added the new `conflict` enum value to the `type` response property for the response status `429`
  - added the new `conflict` enum value to the `type` response property for the response status `500`
  - added the new `payment_required` enum value to the `type` response property for the response status `400`
  - added the new `payment_required` enum value to the `type` response property for the response status `401`
  - added the new `payment_required` enum value to the `type` response property for the response status `403`
  - added the new `payment_required` enum value to the `type` response property for the response status `429`
  - added the new `payment_required` enum value to the `type` response property for the response status `500`
  - added the new optional request property `flows`
  - added the new optional request property `metrics/items/metricId`
  - added the new optional request property `metrics/items/slug`
  - the request property `metrics/items/id` became optional
  - the request property `personas` became optional
  - the request property `scenarios` became optional
  - request property `autoRun` deprecated
  - request property `scenarios` deprecated
  - response property `data/runPlan/scenarios` deprecated
  - added the required property `data/runPlan/flows` to the response with the `201` status
- **2026-04-20** `a1a7faf3a53b`: 1 info
  - added the optional property `data/runPlan/scenarios/items/variables` to the response with the `201` status

---

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