Open Ingress Flow Run workflow
POST/embed/api/workflows/:workflowName/run/stream
conversation embed uses this interface to consume NDJSON runtime events. output node
node_chunk incrementally renders to the assistant bubble during the workflow running;
timer_started / timer_finished incrementally renders the timing card during the workflow running;
The last line run_result returns a complete run record for state convergence and alternate output.
Embed token, login status, fixed target version and entry will be verified before sending NDJSON response header;
Unknown entry returns HTTP 400 JSON, does not create run. Execution error after starting streaming response Continue to use
NDJSON error event.
Kanban Embed calls this interface to return 409 and does not create a running record.
Request
Responses
- 200
- 400
- 401
- 409
NDJSON stream, each line is runtime event, run_result, or error;runtime event contains timer_started / timer_finished, which is used to display business timing cards.
The entry does not exist, the Conversation request carries the entry field, or the request field format is invalid; the response is JSON and NDJSON has not been started.
workflow-code standard error response.
workflow-code standard error response.