Run a simulation plan
Deprecated: use POST /v1/simulation/run, which does the same thing and can also take the plan configuration inline, so a one-off run does not have to create a plan first.
Creates and executes a job for an existing simulation run plan. Optionally provide runtime variables to override plan-defined variables.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Optional request body for running a simulation plan with runtime variables
Values for the {{variables}} the run resolves, overriding whatever the plan has pinned.
An object applies them to the whole run:
{ "orderNumber": "12345", "tier": "gold" }
An array applies them per flow, or to just its happy path or one of its edge cases, when a single set will not do. Each entry carries what it applies to:
[ { "flowId": "550e8400-...", "variables": { "orderNumber": "12345" } }, { "flowId": "550e8400-...", "happyPath": true, "variables": { "orderNumber": "55555" } }, { "flowId": "550e8400-...", "edgeCaseId": "7a3d2e1f-...", "variables": { "orderNumber": "67890" } } ]
An entry that narrows to neither covers everything that flow resolves. A flow this plan does not attach, or an edge case that does not belong to the flow, is rejected rather than ignored.
A plan built on scenarios rather than customer flows targets them the same way, with scenarioId in
place of flowId. That form is deprecated alongside scenarios themselves, and still accepted so runs
against those plans keep working.
- Option 1 · object
- Option 2 · object[]
- Option 3 · object[]
Response
Successfully triggered simulation run plan
Response when triggering a simulation run plan