Utility Nodes

> General-purpose tools for debugging, working with dates and time, encoding data, generating IDs, managing variables, and transforming data.

Utility nodes handle tasks that do not fit neatly into other categories. They include debugging aids, date and time operations, encoding functions, unique ID generation, variable management, and data transformation tools.

Debugging

log-node

Writes a value to the route's execution log. Useful for debugging your flow during development.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | value | Input | any | | label | Input | string | | sequence out | Output | sequence |

The label input is optional and helps you identify log entries when multiple log nodes are used. Logged values appear in the route's execution details in the Dashboard.

Use log nodes liberally during development to inspect values at different points in your flow. You can remove or disconnect them before deploying to production.

Variables

set-variable

Stores a value in a named variable that persists for the duration of the route execution. Use variables to pass data between distant parts of your flow without direct wire connections.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | name | Input | string | | value | Input | any | | sequence out | Output | sequence |

get-variable

Retrieves a value previously stored with set-variable.

| Pin | Direction | Type | |-----|-----------|------| | name | Input | string | | value | Output | any |

Variables are scoped to a single route execution. They are not shared between different requests or routes. Use KV database nodes for persistent storage.

Time and Date

current-time

Returns the current date and time.

| Pin | Direction | Type | |-----|-----------|------| | timestamp | Output | number | | iso | Output | string |

date-formatter

Formats a timestamp or date value into a human-readable date string using a specified format pattern.

| Pin | Direction | Type | |-----|-----------|------| | date | Input | any | | format | Input | string | | result | Output | string |

time-difference

Calculates the difference between two timestamps.

| Pin | Direction | Type | |-----|-----------|------| | start | Input | number | | end | Input | number | | difference | Output | number |

relative-time

Converts a timestamp to a human-readable relative time string (e.g., "5 minutes ago", "in 2 hours").

| Pin | Direction | Type | |-----|-----------|------| | timestamp | Input | number | | result | Output | string |

Encoding

base64-encode

Encodes a string to Base64 format.

| Pin | Direction | Type | |-----|-----------|------| | value | Input | string | | result | Output | string |

base64-decode

Decodes a Base64 string back to its original form.

| Pin | Direction | Type | |-----|-----------|------| | value | Input | string | | result | Output | string |

url-encode

Encodes a string for use in a URL, escaping special characters.

| Pin | Direction | Type | |-----|-----------|------| | value | Input | string | | result | Output | string |

url-decode

Decodes a URL-encoded string back to its original form.

| Pin | Direction | Type | |-----|-----------|------| | value | Input | string | | result | Output | string |

Unique Identifiers

generate-uuid

Generates a random UUID (v4) string.

| Pin | Direction | Type | |-----|-----------|------| | uuid | Output | string |

Each evaluation generates a new UUID. If you need the same UUID in multiple places within a single execution, wire the single output to all nodes that need it.

generate-id

Generates a shorter unique identifier string. Useful when a full UUID is not needed.

| Pin | Direction | Type | |-----|-----------|------| | id | Output | string |

Data Transformation

data-transformer

A flexible node that transforms data from one shape to another using a configured mapping. Use this for reshaping API responses, renaming fields, or restructuring data.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | input | Input | any | | output | Output | any | | sequence out | Output | sequence |

data-filter

Filters data based on configured conditions. Works with arrays of objects to select items matching the specified criteria.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | input | Input | any | | output | Output | any | | sequence out | Output | sequence |

aggregator-node

Aggregates data from an array of objects, performing operations like sum, count, average, min, or max on specified fields.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | input | Input | object:array | | result | Output | any | | sequence out | Output | sequence |

Use the data transformation nodes when you need to reshape complex data structures. They are particularly useful for preparing API responses or transforming database query results before returning them.