#
Workflow Node Reference
This is a complete reference for every node type available in the Weavestream workflow editor. Each entry describes what the node does, how to configure it, and what data it passes along.
#
Trigger
Icon: Play circle | Color: Green
Every workflow starts with a Trigger node. It defines when the workflow runs.
Configuration:
- Manual — Run on demand by clicking the Play button
- Scheduled — Run automatically at an interval:
- Every X minutes
- Hourly
- Daily
- Weekly
Output: Starts the workflow — passes control to the next connected node.
#
Data Source
Icon: Cylinder | Color: Purple
Fetches items from one of your configured endpoints.
Configuration:
- Endpoint — Select which endpoint to fetch data from
Output: A list of items from the selected endpoint.
Connects to: Any node that accepts items as input.
#
Ask for Input
Icon: Question bubble | Color: Cyan
Pauses the workflow and prompts you for manual input. Useful when a workflow needs information that can't be determined automatically.
Configuration:
- Prompt text — The question or instruction shown to the user
Output: The text you enter.
Use case: "Enter the customer name to look up" or "What date range should I analyze?"
#
AI Analysis
Icon: Brain | Color: Orange
Sends data to your configured AI provider for analysis.
Configuration:
- Prompt — The instructions for the AI (what to analyze, what format to use)
- Uses the data from the previous node as context
Input: Items or text from a previous node.
Output: The AI's text response.
Use case: Automatically summarize alerts, identify patterns, or generate reports.
#
Notification
Icon: Bell | Color: Red
Sends a native macOS notification. Requires notification permissions to be enabled.
Configuration:
- Title — The notification title
- Message — The notification body (can reference data from previous nodes)
Input: Text or items from a previous node.
Output: Passes through the input data unchanged.
Use case: Alert yourself when a workflow finds something important.
#
Pushover
Icon: Pushover logo | Color: Blue
Sends a push notification via the Pushover service. This lets you receive notifications on your phone or other devices.
Configuration:
- Pushover credentials — Your Pushover user key and API token (configured in Settings → Credentials)
- Title — The notification title
- Message — The notification body
Input: Text or items from a previous node.
Output: Passes through the input data unchanged.
Use case: Get mobile push notifications for critical events.
#
Save File
Icon: Download arrow | Color: Green
Exports data to a file on your Mac.
Configuration:
- File format — Choose the output format (CSV, JSON, etc.)
- File location — Where to save the file
Input: Items or text from a previous node.
Output: The file path of the saved file.
Use case: Generate daily CSV exports, save analysis reports, or create backups of filtered data.
#
Show Content
Icon: Text bubble | Color: Teal
Displays content in a popup window. Useful for reviewing workflow results without leaving the app.
Configuration:
- Display format — How to present the content
Input: Text or items from a previous node.
Output: Passes through the input data unchanged.
Use case: Preview AI analysis results, display a formatted summary, or show filtered items for review.
#
Condition
Icon: Branching arrow | Color: Blue
Branches the workflow based on a condition. Has two outputs: Then (condition is true) and Else (condition is false).
Configuration:
- Condition — The rule to evaluate (e.g., item count greater than 0, text contains a keyword)
Input: Items, text, count, or boolean from a previous node.
Output: Two branches:
- Then — Executes when the condition is true
- Else — Executes when the condition is false
Use case: "If there are critical alerts, send a notification. Otherwise, save a routine report."
#
Transform
Icon: Magic wand | Color: Purple
Maps or transforms data fields. Use this to reshape data before passing it to the next node.
Configuration:
- Field mappings — Define how input fields map to output fields
- Can rename fields, extract specific values, or combine fields
Input: Items from a previous node.
Output: Transformed items with the new field structure.
Use case: Extract just the fields you need, rename fields for clarity, or prepare data for export.
#
Sort
Icon: Up/down arrows | Color: Magenta
Sorts items by a specified field or date.
Configuration:
- Sort by — The field to sort on
- Order — Ascending or descending
Input: Items from a previous node.
Output: The same items in sorted order.
Use case: Order items by severity before generating a report, or sort by date for chronological exports.
#
Limit
Icon: Number circle | Color: Gray
Restricts the number of items passed to the next node.
Configuration:
- Max items — The maximum number of items to keep
Input: Items from a previous node.
Output: At most the specified number of items (taken from the beginning of the list).
Use case: Only process the top 10 alerts, limit exports to the most recent 50 items.
#
Filter
Icon: Filter lines | Color: Light Blue
Filters items based on conditions, similar to Smart Filters but within a workflow.
Configuration:
- Condition — The rule to apply (field, operator, value)
Input: Items from a previous node.
Output: Only the items that match the condition.
Use case: Narrow down items mid-workflow before sending them to AI analysis or notifications.
#
Connecting Nodes
When connecting nodes, keep these rules in mind:
- No cycles — You can't connect a node back to an earlier node in the chain
- No duplicate inputs — Each node's input port accepts only one connection
- Compatible data types — Connections are validated to ensure the output type of one node is compatible with the input of the next
If a connection isn't valid, Weavestream won't let you create it.
#
Next Steps
- Building Your First Workflow — Hands-on walkthrough
- Scheduling & Running Workflows — Execute and monitor