Breaking: GET /api/v2/workflows/get-input-schema no longer returns the legacy workflowInputs blob. Node literals, agent prompts, and publish messages can now interpolate launch arguments.
Summary
A workflow’s input contract had two representations: the canonical typed arrayworkflowInputSchema, and a legacy untyped workflowInputs blob keyed by field name. The blob is gone — removed from storage, from the platform’s own read paths, and from the public response.This is a breaking change to a published endpoint. GET /api/v2/workflows/get-input-schema no longer returns a workflowInputs key at all.Breaking change
Nothing else about the endpoint changed: the route, theworkflows:read scope, the id query parameter, the 200 / 403 / 404 statuses, and the data.id / data.version / data.workflowInputSchema fields are all unchanged.Migration
Replace any read ofworkflowInputs with workflowInputSchema. The typed array carries the same information plus the field ordering the blob could not express.Before — reading the blob, or falling back to it:Client packages
@tangogroup/forge-sdk—WorkflowInputSchemaResult.workflowInputsremoved. The field was typedunknown, so consumers that never read it need no source change; consumers that did will now fail to compile, which is the intended signal.@tangogroup/forge-mcp— the same field removed fromWorkflowInputSchemaResult. Theforge_get_workflow_input_schematool passes the response through unchanged, so its output no longer carries the key.
Why the blob is gone rather than deprecated
Two representations of one contract meant every reader had to decide which one won, and a “canonical first, legacy fallback” bridge quietly turned an un-backfilled row into an empty contract. Removing the second representation removes that decision.workflowInputSchema is now the only thing stored, the only thing dispatch validates against, and the only thing returned — an empty array means “declares no inputs”, and a version carrying no array at all is refused at dispatch with workflowV2/contract-unmigrated instead of silently launching with none.Background: the typed array came first; a later clear-then-narrow change retired the blob.New: {{workflow.<name>}} interpolation in node literals
The same change added a second way for a node to read a launch argument. Wiring an input with source: { workflowInput: "key" } hands a node a whole slot fed by that argument. Interpolation puts the value inside a string instead — a {{workflow.<name>}} reference the orchestrator substitutes at dispatch.The reference is honoured in three places: a node input’s literal value, an agent node’s prompt text, and a publish node’s message text.Scope rules
{{fieldName}} and {{inputs.fieldName}} are node-scoped — the name must be a key in that node’s resolved inputs — and are honoured only in an agent prompt or a publish message. {{workflow.name}} skips the node entirely and reads the run’s launch arguments, so it needs no inputs entry, but the name must be declared on the workflow’s input contract.Inside a literal, {{workflow.<name>}} is the only form that resolves. A literal has no node-scoped resolver, so {{inputs.x}} and bare {{x}} are passed to the node verbatim.Only literal bindings are interpolated. A value arriving through source or workflowInput is passed through untouched even when it contains {{…}} text, so run data cannot rewrite itself. Object keys are never scanned — only string values.Substitution keeps the type when the reference is the whole string
A literal that is exactly one reference —"{{workflow.regions}}" — is replaced by the typed value, so a string[] workflow input fills an array-typed slot as a real array. A reference embedded in surrounding text — "FY{{workflow.year}}-Q{{workflow.qtr}}" — is stringified and spliced.Failure behaviour differs by surface
An unresolvable reference in aliteral throws and fails the node, naming the input. In an agent prompt or publish message, an unknown key renders as the empty string so operators never see {{undefined}} in a published message.Two validator codes fire before publish:Give any interpolated input a value on every run — required,
derived, or optional carrying a default / defaultExpr. Optional-with-no-default is rejected at publish time: the preflight wiring gate refuses a draft carrying any severity: "error" issue, and wiring errors are not overridable. That strictness is the point — the alternative is a graph that publishes clean and then throws only on the runs where the operator left the field blank, failing in production after passing its first test.Full reference: Reference a workflow input from inside a node.See also: Compose a Workflow | getInputSchema | Workflows HTTP API | Workflow Execution Flow

