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. Always returned in the nested `{ conditions: [groups] }` form (a single condition is one group with one leaf), the same shape Configure Action accepts. `continue_workflow_if_run_condition_not_met` controls whether the chain proceeds when the condition isn't met.

conditionsarray ofrequired

AND/OR condition groups, identical shape to Configure Action's `run_if.conditions`. Outer array = groups (joined by each group's `combinator`); each group's `conditions` = leaf conditions (joined by each leaf's `combinator`).

conditionsarray ofrequired

variablestringrequired

operatorstringrequired

valuesarray ofrequired

combinatorstring

"AND""OR"

combinatorstring

"AND""OR"

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": {
    "conditions": [
      {
        "conditions": [
          {
            "variable": "string",
            "operator": "string",
            "values": [],
            "combinator": "AND"
          }
        ],
        "combinator": "AND"
      }
    ],
    "continue_workflow_if_run_condition_not_met": false
  },
  "next": [
    "string"
  ],
  "note": "string"
}