Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

The JOIN node combines results from parallel branches, allowing you to merge outputs from concurrent operations.

Overview

JOIN nodes enable:
  • Result Merging: Combine outputs from multiple parallel branches
  • Data Aggregation: Aggregate data from concurrent operations
  • Synchronization: Wait for all branches before continuing
  • Output Construction: Build unified output from branch results

How It Works

1

Wait for Branches

JOIN node waits for all connected parallel branches to complete.
2

Collect Results

Collects outputs from all branches.
3

Merge Data

Merges branch outputs into unified result.
4

Continue Flow

Flow continues with merged result.

Configuration

Branch Selection

Select which parallel branches to join:
  • All Branches: Join all branches from PARALLEL node
  • Specific Branches: Select specific branches to join
  • Conditional Join: Join branches based on conditions

Output Construction

Define how to merge branch outputs:
  • Merge Strategy: How to combine branch outputs
  • Output Schema: Define merged output structure
  • Conflict Resolution: How to handle conflicting fields

Output Strategies

Merge All

Combine all branch outputs:
{
  "branch1": { ... },
  "branch2": { ... },
  "branch3": { ... }
}

Flatten

Flatten branch outputs into single object:
{
  "field1": "value1",
  "field2": "value2",
  "field3": "value3"
}

Custom

Define custom merge logic using expressions.

Use Cases

  • Data Aggregation: Combine results from multiple API calls
  • Parallel Processing: Merge outputs from concurrent operations
  • Data Enrichment: Combine data from different sources
  • Result Consolidation: Unify results from parallel branches

Best Practices

Consistent Structure

Ensure branch outputs have consistent structure

Handle Missing Data

Account for branches that may fail

Define Schema

Clearly define merged output schema

Test Merging

Test merge logic with various inputs

Next Steps

PARALLEL Node

Create parallel branches

Transform Node

Transform merged results