---
title: "Create Run"
method: POST
path: "/v1/runs"
tags: ["Runs"]
---

# Create Run

`POST /v1/runs`

Creates a new Run from a Flow template.

## Request body

- CreateRunRequest
  - `flowId` string, required — The Flow ID.
  - `version` integer — The Flow template version. Defaults to the latest version when omitted.
  - `input` object — Initial input for the Run. Refer to the Flow template for specific `input` requirements.

## Response `201`

A Run ID

- CreateRunResponse
  - `flowRunId` string, required — The Sohar ID for the Run.

## Other responses

- `400` — Invalid request
- `403` — Unauthorized
- `500` — Internal error

---

[API](https://skmtc.dev/soharhealth/apis/sohar-api.md) · [All operations](https://skmtc.dev/soharhealth/apis/sohar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soharhealth/sohar-api/revisions/2cb5fa45c18c/schema)