http-request Function Type

The http-request function type makes arbitrary HTTP requests to any endpoint. This function type can be used in both Actions and Flow Nodes.

Usage

• Actions - Use http-request action type to make HTTP requests to any external endpoint
• Flow Nodes - Use custom-http-request node type to make HTTP requests within flows

Examples

Action Implementation

name: Call External API
key: call-external-api
type: http-request
config:
  request:
    uri:
      $var: $.input.endpoint
    method: GET
    headers:
      Authorization:
        $formula: "Bearer " + $.input.apiKey
      Content-Type: application/json
    query:
      limit: 100
  allowNon2xx: false

Flow Node Implementation

name: Call External API
type: custom-http-request
config:
  url:
    $var: input.apiEndpoint
  method: POST
  headers:
    Authorization:
      $concat:
        - "Bearer "
        - $var: input.apiToken
    Content-Type: application/json
  body:
    data:
      $var: input.payload
  timeout: 30000

Configuration Parameters

Action Parameters

• request.uri - Request URI (required)
• request.method - HTTP method (defaults to GET)
• request.body - Request body
• request.query - Query parameters
• request.headers - HTTP headers
• responseSchema - Expected response schema (optional)
• allowNon2xx - Allow non-200 responses (optional)

Flow Node Parameters

• url - Request URL (supports formulas)
• method - HTTP method (GET, POST, PUT, DELETE, etc.)
• headers - HTTP headers (supports formulas)
• body - Request body (supports formulas)
• query - Query parameters (supports formulas)
• timeout - Request timeout in milliseconds (optional)

Batch Mode

In Flow Nodes, you can enable batch mode to avoid sending dozens or hundreds of HTTP requests. When using Batch Mode, the node's input becomes a list of up to batchSize items.