---
title: "Execute Runchat Flow"
method: POST
path: "/{runchat_id}"
tags: ["Execution"]
---

# Execute Runchat Flow

`POST /{runchat_id}`

Executes a Runchat flow by creating a new instance or continuing an existing one. Requires input data matching the flow's API inputs or a webhook structure.

## Request body

- ExecutionRequest — Request body for executing a Runchat flow.
  - `runchat_instance_id` string — Optional identifier to continue an existing Runchat instance.
  - `inputs` object — Object containing input data keyed by 'paramId_nodeId'. Values can be primitive types, arrays, or structured objects for tree/list inputs (e.g., {"0": [...], "0:1": [...]}).

## Response `200`

Successful execution of the Runchat flow.

- object
  - `metadata` string, json — Stringified JSON containing execution metadata.
  - `runchat_instance_id` string — The unique identifier for the Runchat instance to be used. If omitted a new instance will be created.
  - `data` BasicParameter[] — Array of output data from the executed nodes.
    - `id` string, required — Unique identifier for the parameter, often in the format 'paramKey_parentNodeId'.
    - `label` string, required — User-friendly label for the parameter.
    - `type` 'string' | 'number' | 'boolean' | 'object' | 'image' | 'video' | 'audio' | 'model' | 'message' | 'context' | 'code' | 'array' | 'instruction' | 'null' | 'markdown' | 'file' | 'format' | 'html' | 'pdf' | 'trigger' | 'select', required — Enumeration of supported data types within Runchat.
    - `description` string, required — Description of the parameter.
    - `data` object[], required — The actual data associated with the parameter, represented as an array of items.

## Other responses

- `400` — Bad Request - The request could not be understood or was missing required parameters.
- `500` — Internal Server Error - An unexpected error occurred on the server.

---

[API](https://skmtc.dev/runchat/apis/runchat-api.md) · [All operations](https://skmtc.dev/runchat/apis/runchat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runchat/runchat-api/revisions/ccf82c335a7e/schema)