---
title: "Start a workflow"
method: POST
path: "/workflow-runs"
tags: ["Workflows"]
---

# Start a workflow

`POST /workflow-runs`

Starts execution of a workflow with the given inputs.
Returns a run ID that can be used to track progress.

## Request body

- StartWorkflowRequest
  - `workflow_id` string, required — ID/name of the workflow to start
  - `input` object — Input parameters for the workflow
  - `version` integer — Optional specific workflow version

## Response `200`

Workflow started

- WorkflowRunResponse
  - `run_id` string
  - `workflow_id` string
  - `status` 'pending' | 'running' | 'waiting_approval' | 'completed' | 'failed'
  - `message` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `503` — Workflow service not configured

---

[API](https://skmtc.dev/cloudshipai/apis/station-dynamic-agent-mcp-api.md) · [All operations](https://skmtc.dev/cloudshipai/apis/station-dynamic-agent-mcp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudshipai/station-dynamic-agent-mcp-api/revisions/ebdd92944c61/schema)