---
title: "Api Workflow Runs Create"
method: POST
path: "/api/workflow-runs/"
tags: ["platformApi"]
---

# Api Workflow Runs Create

`POST /api/workflow-runs/`

Execute a workflow manually. Returns the completed result or a paused run id for workflows with async (human) steps.

## Headers

- `Authorization` string, required

## Request body

- WorkflowRunCreateRequest — Request payload for creating a workflow run. POST /api/workflow-runs/ Resume/cancel is handled by PATCH on /api/workflow-runs/{run_id}/.
  - `workflow_id` string, required — Workflow ID (or versioned ID 'workflow_id:version') to execute.
  - `payload` object
  - `event_type` string, nullable

## Response `200`

- WorkflowRunExecutionResponse — Response for POST /api/workflow-runs/ (manual run). Covers both outcomes from run_workflow_manually: - completed → {status, results} - paused → {status, workflow_run_id, paused_at_step}
  - `status` string, required — 'completed' or 'paused'.
  - `results` unknown
  - `workflow_run_id` string — Run id to resume later (paused runs only).
  - `paused_at_step` string, nullable — Label of the step that paused the run.

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)