---
title: "Initialize a workflow run from a workflow version."
method: POST
path: "/workflow-runner/runs"
tags: ["Workflow Runner"]
---

# Initialize a workflow run from a workflow version.

`POST /workflow-runner/runs`

## Request body

- WorkflowRunnerInitializeWorkflowRunRequest — Workflow run information to be presented for the initialization.
  - `workflowRunMode` 'DRY' | 'REAL', required
  - `workflowRunName` string, nullable
  - `workflowVersionId` string, required — Workflow version identifier. It is a string composed of the type identifier and a UUID: `workflow.version:[UUID]`.

## Response `201`

Created

- string — Workflow run identifier. It is a string composed of the type identifier and a UUID: `workflow.run:[UUID]`.

---

[API](https://skmtc.net/simscale/apis/simscale-api.md) · [All operations](https://skmtc.net/simscale/apis/simscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/simscale/simscale-api/revisions/53223abaceb7/schema)