Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
subject
string
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}.

Pattern: ^ms\.hub\.config\.workflow\.
trigger
object

Run input, referenced in nodes via $.trigger

triggers
object[]

Batch execution (use either trigger or triggers)

await
boolean
default:false

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

enable_log
boolean
default:true

Store detailed run logs (searchable via searchRunLogs)

knowledge
string[]

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

session_id
string

Agent conversation continuity; omit for new sessions

run_id
string

Full tracking id of a paused or errored run to resume (human-in-the-loop), in the form ms.hub.run.., 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.

retry
boolean

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).