Variables
Nodes for reading, writing, and manipulating pattern variables, secrets, and environment values.
Variable nodes let you store, retrieve, and modify data during pattern execution. Variables persist for the lifetime of a single execution run. For values that persist across runs, use workspace secrets.
This category contains a mix of pure nodes (Get Variable, Get Environment, Get Secret) and impure nodes (Set Variable, Increment Variable, Append to Array, Append to String).
Get Variable
Read a variable by name. Returns the current value stored under that name.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Name | Input | String | The variable name to read |
| Value | Output | Any | The stored value |
Pure. Use Get Variable to access data set earlier in the execution flow — counters, intermediate results, or accumulated lists.
Set Variable
Write a value to a named variable.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Exec | Input | Exec | Triggers the write |
| Name | Input | String | The variable name to write |
| Value | Input | Any | The value to store |
| Exec | Output | Exec | Continues after the write |
Impure. Use Set Variable to save intermediate results, counters, or state that other nodes need later.
Increment Variable
Add a numeric amount to an existing variable.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Exec | Input | Exec | Triggers the increment |
| Name | Input | String | The variable name to increment |
| Amount | Input | Float | Value to add (default: 1) |
| Exec | Output | Exec | Continues after the increment |
| New Value | Output | Float | The variable's value after incrementing |
Impure. Use Increment Variable for counters — tracking processed items, failed attempts, or API call counts.
Append to Array
Push an item onto the end of an array variable.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Exec | Input | Exec | Triggers the append |
| Name | Input | String | The array variable name |
| Item | Input | Any | The item to append |
| Exec | Output | Exec | Continues after the append |
Impure. Use Append to Array to build up a list during a loop — collecting results, errors, or matched items.
Append to String
Concatenate text onto the end of a string variable.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Exec | Input | Exec | Triggers the append |
| Name | Input | String | The string variable name |
| Text | Input | String | The text to concatenate |
| Exec | Output | Exec | Continues after the append |
Impure. Use Append to String to build up log messages, report content, or formatted output incrementally.
Get Environment
Read an environment variable by name.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Name | Input | String | The environment variable name |
| Value | Output | String | The environment variable value |
Pure. Use Get Environment to read deployment-specific configuration like API base URLs or feature flags.
Get Secret
Retrieve a workspace secret by name. Secrets are scoped to the current environment and can be either plain text strings or key-value maps.
| Pin | Direction | Type | Description |
|---|---|---|---|
| Secret Name | Input | String | The secret path to retrieve |
| Value | Output | Any | The secret value (string or object) |
Pure. Use Get Secret to access API keys, tokens, and credentials stored in the workspace secrets manager.
Related categories
- Literals — provide constant values as inputs
- Flow Control — use variables with Branch, For Each, and other control nodes
- String — manipulate string variable values