curl --request POST \
--url https://api.quiva.ai/hub/workflows/run \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subject": "ms.hub.config.workflow.4285896071.1009853675",
"trigger": {
"description": "reverses a string"
},
"await": true
}
'{
"tracking_id": "ms.hub.run.abc123.ms.hub.config.workflow.4285896071.1009853675",
"result": "export function reverse(s){return [...s].reverse().join('')}"
}{
"error": "<string>"
}{
"error": "<string>"
}Execute a workflow
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.
curl --request POST \
--url https://api.quiva.ai/hub/workflows/run \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subject": "ms.hub.config.workflow.4285896071.1009853675",
"trigger": {
"description": "reverses a string"
},
"await": true
}
'{
"tracking_id": "ms.hub.run.abc123.ms.hub.config.workflow.4285896071.1009853675",
"result": "export function reverse(s){return [...s].reverse().join('')}"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Body
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).