Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Path Parameters

collection_topic
string
required

The topic is a hash of the name that was used when a collection was created

flow_topic
string
required

Flow topic - hash of the names the node was created with

Query Parameters

draft
boolean

Draft flag

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

Workflow executed successfully

trackingId
string

ID for tracking the workflow execution

result
object

Result of the workflow execution