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 START node is the entry point of every flow. It defines what inputs the flow accepts and how the flow can be triggered.

​
Overview

The START node:
  • Defines Input Schema: JSON Schema specifying accepted parameters
  • Configures Trigger: Webhook, schedule, manual, or MCP tool trigger
  • Validates Inputs: Ensures incoming data matches the schema
  • Provides Context: Makes input data available to subsequent nodes

​
Input Schema

The input schema defines what data your flow accepts:
  • JSON Schema Format: Standard JSON Schema specification
  • Type Validation: Validates parameter types (string, number, boolean, object, array)
  • Required Fields: Mark fields as required or optional
  • Default Values: Provide default values for optional fields

​
Example Input Schema

{
  "type": "object",
  "properties": {
    "userId": {
      "type": "string",
      "description": "User ID to process"
    },
    "action": {
      "type": "string",
      "enum": ["create", "update", "delete"],
      "description": "Action to perform"
    },
    "metadata": {
      "type": "object",
      "description": "Additional metadata"
    }
  },
  "required": ["userId", "action"]
}

​
Trigger Configuration

Configure how the flow is triggered:
  • Webhook Trigger: HTTP endpoint for external systems
  • Scheduled Trigger: Cron-based automatic execution
  • Manual Trigger: Execute from UI or API
  • MCP Tool Trigger: Expose as tool for AI clients
Each flow can have multiple triggers. Configure triggers in the START node settings.

​
Accessing Input Data

Reference input data in subsequent nodes using expressions: 
{{START.userId}}
{{START.action}}
{{START.metadata.fieldName}}

​
Best Practices

Define Clear Schemas

Use descriptive field names and descriptions

Mark Required Fields

Clearly mark which fields are required

Use Enums

Use enum for fields with limited options

Provide Defaults

Set default values for optional fields when possible

​
Next Steps

END Node

Learn about flow output

Flow Triggers

Configure flow triggers