v52

OpenAPI 3.1.0raw.githubusercontent.com2026-08-033240556.8 KB
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 swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. 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 — only 'trigger' and 'input' are. Example: { "cityData": "generate-city" } → use {{cityData.taskOutput.field}} in config templates. For trigger data: { "pr": "trigger.pullRequest" }.

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)