Sign in

v1

latestOpenAPI 3.1.02026-07-13182388559.6 KB

Execute an inline workflow definition (ephemeral run). The definition must use "manual" trigger type. No workflow is saved — the definition is executed once and the run is recorded with workflowId="". Requires WorkflowCreate permission.

post/v1/runs

Request body

payloadobject

Payload is merged into the trigger result (root node output), accessible via {{root.result.key}} expressions. A "triggeredAt" timestamp is always added automatically.

propValuesobject

PropValues are template parameter values injected into the run context, accessible via {{$props.key}} expressions.

runIdstring

RunID is an optional client-generated run ID. Must start with "run_" prefix. If omitted, a run ID is generated server-side. Use this to subscribe to SSE stream before triggering the run.

Example request

{
  "runId": "run_abc123"
}

Response

Run created and enqueued for execution

codeinteger
messagestring
requestIdstring

Example response

{
  "code": 200,
  "data": {
    "runId": "run_c9i6j8k2l0m3"
  },
  "message": "success",
  "requestId": "abc-123"
}