---
title: "Run a published workflow"
method: POST
path: "/v1/workflows/{id}"
tags: ["Workflows"]
---

# Run a published workflow

`POST /v1/workflows/{id}`

Start a new task to execute a published workflow. You can optionally provide custom input values via `nodeOutputs` to override the defaults defined in the workflow graph.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Runway-Version` '2024-11-06', required

## Request body

- object
  - `nodeOutputs` object — Optional node outputs to override default values. Keys are node IDs from the workflow graph, values are objects mapping output keys to typed values.

## Response `200`

The response from running a workflow.

- object
  - `id` string, uuid, required — The ID of the workflow invocation that was created.

## Other responses

- `404` — The published workflow does not exist or was deleted.

---

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