QUquivaworks

Execute a workflow

Changed on

Run a published workflow. await=true returns results synchronously; await=false returns a tracking_id immediately. Resume a paused (input/human-in-the-loop) run by passing its run_id plus the human response as trigger.

Resuming a run that is not paused or errored answers 409; it does not start the flow again. The paused entry is claimed when the resume is accepted, so a second submit is refused. A call with await: false can now return an error, including start-up failures, and waits for the first stream write.

post/hub/workflows/run

Request

Request body

subjectstring required

Workflow subject. Published: ms.hub.config.workflow.{collection}.{flow} (NO 'published' segment - get it from listWorkflows version=published). Draft: ms.hub.config.workflow.draft.{collection}.{flow}.

triggerobject

Run input, referenced in nodes via $.trigger

triggersobject[]

Batch execution (use either trigger or triggers)

awaitboolean

true = wait for completion and return results; false = return tracking_id immediately

enable_logboolean

Store detailed run logs (searchable via searchRunLogs)

knowledgestring[]

Knowledge URIs for agents: kv://, obj://, str://, sid://, dta://

session_idstring

Agent conversation continuity; omit for new sessions

run_idstring

Full tracking id of a paused or errored run to resume (human-in-the-loop), in the form ms.hub.run.<uuid>.<flow subject>, as returned when the run started and by the paused-runs list. A bare uuid is rejected with 400 invalid run_id. Resuming a run that is not paused or errored returns 409.

retryboolean

Retry a failed run

Response

Run result. { tracking_id, result }. If config.result was set, result matches that JSONPath selection; otherwise result is the step-by-step log array where items with a 'paused': true flag indicate a human-in-the-loop pause (resume with run_id).

Changes