Skip to main content
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.
Calls POST /v1/simulation/plan/{planId}/job

Arguments

string
required
Simulation run plan ID.

Options

string
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.

Example

Every command also takes the global options and sets one of the exit codes.