---
title: "POST /api/v1/workflows/{id}/run"
method: POST
path: "/api/v1/workflows/{id}/run"
tags: ["workflows"]
---

# POST /api/v1/workflows/{id}/run

`POST /api/v1/workflows/{id}/run`

## Path parameters

- `id` string, required

## Request body

- RunWorkflowRequestDto
  - `inputs` object
  - `versionId` string, uuid
  - `version` integer

## Response `201`

Workflow execution result

- object
  - `runId` string — Temporal workflow identifier
  - `workflowId` string — Workflow record id
  - `temporalRunId` string — Temporal first execution run id
  - `taskQueue` string — Temporal task queue used for execution
  - `workflowVersionId` string — Workflow version identifier used for execution
  - `workflowVersion` integer — Workflow version number used for execution
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'UNKNOWN'

---

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