Visual Workflows

The workflow editor lets you build multi-step API automation as a visual graph. Chain requests, add conditions, loops, retry logic, and error handling — then run it and watch each step execute in real time.

Opening the Editor

1. Click Workflows in the sidebar
2. Click + New Workflow — a template picker lets you start from a pre-built example
3. Or click an existing workflow to open it

Node Types

Node	What it does
Start	Entry point — every workflow needs one
End	Terminal node — you can have multiple (e.g. success + error)
HTTP Request	Sends an HTTP request with optional retry and assertions
Condition	Branches true/false on a JavaScript expression
Loop	Repeats N times or over an array
Transform	Extracts/reshapes data and stores the result in a variable
Delay	Pauses for N milliseconds
Set Variable	Writes a value to an environment or global variable
Comment	Sticky note for documenting the workflow — does not execute
Sub-Workflow	Calls another saved workflow as a single step

Retry Logic

On any HTTP Request node, set:

• Retry Count — up to 5 automatic retries
• Backoff — Fixed, Linear (delay × attempt), or Exponential (delay × 2ⁿ)
• Retry on Status Codes — only retry for specific codes like 429, 500, 503

Response Assertions

Add pass/fail checks to any request node without writing scripts:

• Check status code, JSON body field (JSONPath), response header, or response time
• Nine operators: eq, neq, gt, lt, contains, exists, inRange, and more
• A failed assertion routes to the error edge if connected

Error Handling

Every node has a red error handle on the bottom-right. Connect it to any downstream node to handle failures:

$error.message   — error description
$error.status    — HTTP status code
$error.nodeId    — which node failed

Run History

Every execution is saved automatically. Open the History tab in the palette to replay any past run — full trace, timings, and variable values.

Templates

When creating a new workflow, choose a template:

Template	What it shows
API Health Check	Status assertion
Data Pipeline	Fetch → Transform → Post
Auth Flow	Login → Token → Authenticated request
CRUD Suite	Create → Read → Update → Delete
Retry Resilience	Backoff retry + error routing

Import / Export

• Export any workflow as a .rostyman-workflow file to share or back up
• Import from file — nodes, edges, and all config are restored

Keyboard Shortcuts

Shortcut	Action
Ctrl+Z	Undo
Ctrl+Y	Redo
Delete	Remove selected node or edge
Ctrl+S	Save workflow

More Information

See the full Visual Workflows guide on the documentation site.