ActionGraphNode

One node in the workflow's action graph. `data[0]` is always the synthetic input node (`action_id: "input"`); subsequent elements are actions in topological execution order.

Properties

action_instance_idstringrequired

Unique ID of this node within the sheet. The synthetic input node uses `"input"`; action nodes use their per-sheet instance ID.

action_idstringrequired

Action template identifier. The synthetic input node uses `"input"`; action nodes use their template ID.

display_namestringrequired

User-facing name of the node.

inputsobject

Configured input wiring for this action: map of field name → value (literal / reference / waterfall array). Unconfigured fields are absent. Absent entirely on the input node.

outputsarray of

Fields this node produces. On the input node, one entry per configured input field. Absent on actions that produce no outputs.

ActionOutput

continue_workflow_if_action_failsboolean

When `true`, downstream actions still run for a row even if this action fails. Mirrors the value set via Configure Action's `continue_workflow_if_action_fails`. Absent when the action has never had it configured.

run_ifobject

Conditional gate that decides whether this action runs for a given row. Mirrors the value set via Configure Action's `run_if`. Absent when no condition is configured. `variable` is a public reference token; `operator` is the stored comparison operator; `values` is the comparison set; `continue_workflow_if_run_condition_not_met` controls whether the chain proceeds when the condition isn't met.

variablestringrequired

operatorstringrequired

valuesarray ofrequired

continue_workflow_if_run_condition_not_metbooleanrequired

When `true`, downstream actions still run for a row even when this action's condition isn't met. Default `false`.

nextarray ofrequired

Downstream `action_instance_id`s. `[]` is terminal. Multiple IDs represent a branch point (reserved — currently at most one ID is populated).

string

notestring

Free-text note attached to this action via Save Action Note (or Configure Action's `note` field). Absent when no note has been saved.

Example

ActionGraphNode example

{
  "action_instance_id": "input",
  "action_id": "input",
  "display_name": "Inputs",
  "inputs": {},
  "outputs": [
    {
      "name": "full_name",
      "type": "string",
      "reference": "{{enrich_person_linkedin_profile_1.full_name}}",
      "description": "Work history as JSON. Each item: title, company, start_date, end_date, summary, url, company_domain, company_identifier",
      "columns": [
        {
          "name": "string",
          "type": "string",
          "structured_array_reference": "{{raw_to_structured_array_1.list.first_name}}"
        }
      ]
    }
  ],
  "continue_workflow_if_action_fails": false,
  "run_if": {
    "variable": "{{input.country}}",
    "operator": "is",
    "values": [
      "US",
      "CA"
    ],
    "continue_workflow_if_run_condition_not_met": false
  },
  "next": [
    "string"
  ],
  "note": "string"
}