v

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-09347691.3 MB
Workflows

Patch a single node in a workflow definition

patch/api/workflows/{id}/nodes/{nodeId}

Path parameters

idstring required
nodeIdstring required

Request body

typestring

Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'

labelstring

Human-readable label for UI display

configobject

Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput}).

inputsobject

REQUIRED for cross-node data access. Maps local names to context paths. Without this, upstream step outputs are NOT available for interpolation; built-in trigger/input/workflow/swarm/run context remains available. Example: { "cityData": "generate-city" } → use {{cityData.taskOutput.field}} in config templates. For trigger data: { "pr": "trigger.pullRequest" }. This mapping works in agent-task templates and ordinary config, but executable script/swarm-script source excludes trigger and upstream-output aliases. Route those dynamic values through config.args (argv for inline scripts) instead.

inputSchemaobject

JSON Schema to validate resolved inputs before execution

outputSchemaobject

JSON Schema to validate the executor's output (e.g. {taskId, taskOutput} for agent-task). Different from config.outputSchema which validates the agent's raw output.

Response

Node patched (version snapshot created)

idstring uuid required
keystring required

Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

namestring required
descriptionstring
enabledboolean required
inputobject
triggerSchemaobject
dirstring
vcsRepostring
createdByAgentIdstring
createdAtstring required
lastUpdatedAtstring required
createdBystring
updatedBystring
favoriteboolean