Create and trigger a workflow run

post

https://api2.pennsieve.io/compute/workflows/runs

Primary endpoint: create + trigger a run. Provide either workflowInstanceId
(existing config) or workflowInstanceConfiguration (find-or-create config).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Run request payload

workflowInstanceId

string

UUID of an existing workflow instance config (mode 1)

workflowInstanceConfiguration

object

Inline config for find-or-create (mode 2)

datasetId

string

dataSources

object

Structured data-source inputs keyed by data-source node ID. Each entry must match a data-source node in the workflow definition.

dataTargets

object

Per-data-target inputs keyed by data-target node ID. The user provides per-run values (e.g. folder). The system enriches each entry with registry params (e.g. uploadBucket).

processorParams

object

Per-processor runtime parameters keyed by processor node ID.

layers

array of strings

Persistent layer names to mount for this execution. Layers must exist with status READY on the compute node.

layers

Responses

200The run was successfully triggered

403Forbidden. Possible reasons: user lacks access to compute node, or workflow contains processor source URLs not in the compute node's allowed processors whitelist.

4XXIncorrect authentication or user has incorrect permissions.

5XXServer Error