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 ACTION node executes HTTP requests or calls other tools (including other flows) within your flow.

​
Overview

ACTION nodes enable:
  • HTTP Requests: Make HTTP calls to external APIs
  • Tool Execution: Call other tools (custom tools, provider tools, flows)
  • Response Handling: Access response data in subsequent nodes
  • Error Handling: Built-in retry and error handling

​
Action Types

​
HTTP Actions

Make HTTP requests to external APIs:
  • Method: GET, POST, PUT, PATCH, DELETE
  • URL: Request URL (supports variable expressions)
  • Headers: Custom headers
  • Body: Request body for POST/PUT/PATCH
  • Authentication: Bearer token, API key, basic auth

​
Tool Actions

Call other tools:
  • Tool Selection: Choose from available tools
  • Parameter Mapping: Map flow variables to tool parameters
  • Response Access: Access tool response in subsequent nodes

​
Configuration

​
HTTP Action Configuration

1

Select HTTP

Choose “HTTP” as action type.
2

Set Method

Select HTTP method (GET, POST, etc.).
3

Configure URL

Enter URL (can use expressions like {{START.apiUrl}}).
4

Add Headers

Configure headers if needed.
5

Set Body

For POST/PUT/PATCH, configure request body.

​
Tool Action Configuration

1

Select Tool

Choose “Tool” as action type.
2

Choose Tool

Select the tool to call from available tools.
3

Map Parameters

Map flow variables to tool parameters.

​
Parameter Mapping

Map flow variables to action parameters:
  • Direct Mapping: {{START.userId}} → userId parameter
  • Expressions: Use expressions for transformations
  • Nested Access: {{previous_node.response.data.id}}

​
Example Mapping

{
  "userId": "{{START.userId}}",
  "action": "{{START.action}}",
  "timestamp": "{{$now}}"
}

​
Response Access

Access action response in subsequent nodes: 
{{action_node.response.status}}
{{action_node.response.data}}
{{action_node.response.headers}}

​
Error Handling

ACTION nodes include built-in error handling:
  • Retry Logic: Automatic retry with exponential backoff
  • Circuit Breaker: Fault tolerance for external services
  • Rate Limiting: Respects rate limits
  • Timeout: Configurable timeout per action

​
Retry Configuration

Configure retry behavior:
  • Max Attempts: Maximum retry attempts
  • Backoff: Exponential backoff delay
  • Retryable Errors: Which errors trigger retries

​
Best Practices

Use Expressions

Use expressions for dynamic URLs and parameters

Handle Errors

Use TRY nodes to handle action errors

Set Timeouts

Configure appropriate timeouts

Log Responses

Use LOG nodes to debug action responses

​
Next Steps

Transform Node

Transform action responses

TRY Node

Handle action errors