---
title: "Execute Workflow"
method: POST
path: "/api/mcp/v1/workflows/{hash}/execute"
tags: ["Workflows"]
---

# Execute Workflow

`POST /api/mcp/v1/workflows/{hash}/execute`

## Request

- Base URL: `https://flowdot.ai/api`
- URL: `https://flowdot.ai/api/api/mcp/v1/workflows/{hash}/execute`
- Auth: HTTP bearer

Execute a workflow with provided inputs.

## Path parameters

- `hash` string, required

## Request body

- object
  - `mode` 'flowdot' | 'simple' | 'capable' | 'complex': LLM mode for custom nodes
  - `inputs` object: Input values keyed by input node names
  - `wait_for_completion` boolean: Wait for execution to complete

## Response `200`

Successful response

- unknown

## Other responses

- `401`: Unauthenticated
- `403`: Not authorized to execute this workflow
- `404`: Workflow not found
- `422`: Invalid inputs

---

[API](https://skmtc.dev/flowdot/apis/flowdot-api.md) · [All operations](https://skmtc.dev/flowdot/apis/flowdot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flowdot/apis/flowdot-api/revisions/93f63cc9c775?raw)