Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01144108427.9 KB
Workflow (public)

Execute Public Workflow

Stream a public flow on behalf of a shareable-playground visitor. Mirrors the security posture of /api/v1/build_public_tmp.

post/api/v2/workflows/public

Request body

filesstring[] nullable

Optional list of pre-uploaded file paths. Each path must be scoped to this flow's own storage namespace; the endpoint rejects path traversal or cross-flow references.

flow_idstring required

UUID of the public flow to run.

input_valuestring

Chat-style input value.

mode'stream'

Always stream. Sync/background modes would widen the public attack surface (job polling, owner impersonation persists across queue boundaries) so the schema rejects them at the wire.

session_idstring nullable

Optional caller session. Always namespaced under the visitor's virtual flow id by the endpoint.

start_component_idstring nullable

Partial-run start component id.

stop_component_idstring nullable

Partial-run stop component id.

stream_protocolstring

Wire protocol for streaming events. Defaults to langflow (raw EventManager payloads). agui emits AG-UI events. Unknown values return 422 with the available list.

Example request

{
  "flow_id": "67ccd2be-17f0-8190-81ff-3bb2cf6508e6",
  "input_value": "Hello from the shareable playground"
}

Response

Workflow execution response

OR