Skip to main content
Kasava Workflows let you automate development tasks through a visual workflow builder. Create custom automation by connecting nodes that execute tools, call AI agents, transform data, and more.

​
Overview

The Workflow Builder enables:
  • Visual drag-and-drop workflow creation
  • AI-powered automation steps
  • Conditional branching and parallel execution
  • Human approval gates for sensitive operations
  • Real-time validation and testing

​
Accessing Workflows

1

Navigate to Workflows

Click “Workflows” in the sidebar under “Build”, or go to Settings > Workflows
2

View Your Workflows

The left panel shows all your workflows with status indicators
3

Create or Select

Click “New Workflow” or select an existing workflow to edit
Workflows page showing master-detail layout with workflow list and editor

​
Workflow Builder Interface

​
Master-Detail Layout

The Workflows page uses a two-panel layout:
  • Left Panel: Workflow list with search and filters
  • Right Panel: Visual workflow editor or creator

​
Workflow List

Each workflow shows:
  • Name: Workflow title
  • Status: Active or inactive toggle
  • Validation: Error indicators if issues exist
  • Last Execution: When the workflow last ran

​
Creating a New Workflow

1

Click New Workflow

Use the button at the top of the workflow list
2

Enter Name

Provide a descriptive name for your workflow
3

Build in Editor

Add nodes and connections in the visual editor
4

Save

Click Save to store your workflow

​
Node Types

Drag nodes from the palette onto your workflow canvas:

​
Tool Call

Purpose: Execute an external tool or API call
PropertyDescription
IconWrench (blue)
Use CaseExternal integrations, API calls
ConfigurationTool selection, input parameters

​
Agent Call

Purpose: Call an AI agent with a prompt
PropertyDescription
IconBot (purple)
Use CaseAI analysis, content generation
ConfigurationAgent selection, prompt template

​
Transform

Purpose: Transform data with JavaScript
PropertyDescription
IconCode (green)
Use CaseData manipulation, formatting
ConfigurationJavaScript function
Example transform code: 
function transform(data) {
  return {
    ...data,
    processedAt: new Date().toISOString(),
    formattedName: data.name?.toUpperCase(),
  };
}

​
Conditional

Purpose: Branch workflow based on a condition
PropertyDescription
IconGitBranch (orange)
Use CaseDecision points, error handling
ConfigurationCondition function, error behavior
Conditional nodes have two outputs:
  • True branch: When condition returns true
  • False branch: When condition returns false

​
Parallel

Purpose: Execute multiple paths concurrently
PropertyDescription
IconLayers (pink)
Use CaseConcurrent operations, performance
ConfigurationBranch count (2-10), merge strategy
Merge strategies:
StrategyBehavior
AllWait for all branches to complete
AnyContinue when first branch succeeds
RaceContinue when first branch finishes
All SettledWait for all, continue regardless of failures

​
Suspend

Purpose: Pause workflow for human approval
PropertyDescription
IconClock (purple)
Use CaseApproval gates, manual review
ConfigurationMessage, approvers, timeout
Node palette showing all available node types

​
Building a Workflow

​
Adding Nodes

  1. From Palette: Click a node type to add it, or drag and drop
  2. Positioning: Drag nodes to arrange them on the canvas
  3. Connecting: Drag from output handle to input handle to connect

​
Configuring Nodes

  1. Click a node to select it
  2. Configuration panel opens on the right
  3. Fill in required settings
  4. Changes save automatically

​
Connecting Nodes

  • Drag from a node’s output (bottom) to another node’s input (top)
  • Connections show data flow direction
  • Conditional and parallel nodes have multiple outputs
Workflow canvas with connected nodes showing data flow

​
Workflow Validation

Kasava validates workflows in real-time:

​
Validation Checks

  • All nodes have required configuration
  • Connections are complete
  • No orphaned nodes
  • Conditional branches are connected
  • Parallel branches match configured count

​
Validation Indicators

  • Green check: Workflow is valid and can be activated
  • Yellow warning: Minor issues that won’t block execution
  • Red error: Must be fixed before activation

​
Common Validation Errors

ErrorSolution
Missing tool selectionConfigure the tool in node settings
Disconnected nodesConnect all nodes to the workflow
Missing branch connectionConnect all conditional/parallel outputs
Empty conditionAdd condition logic to conditional nodes

​
Approval Workflows

​
Suspend Nodes for Approvals

Add human approval gates to your workflows:
1

Add Suspend Node

Drag a Suspend node where approval is needed
2

Configure Message

Write a clear approval message explaining what needs review
3

Set Approvers (Optional)

Specify email addresses of required approvers
4

Set Timeout

Configure how long to wait (1-90 days)

​
Approval Settings

SettingDescription
Approval MessageContext shown to approvers
Required ApproversEmail addresses (optional)
Timeout DaysAuto-reject after this period
Auto-Reject on TimeoutWhether to fail workflow on timeout

​
Managing Approvals

Access pending approvals at /workflows/approvals:
  1. View all pending approval requests
  2. See workflow context and message
  3. Add review notes
  4. Approve or reject
Approval detail dialog showing workflow context and action buttons

​
Running Workflows

​
Activating Workflows

  1. Ensure workflow validation passes
  2. Toggle the “Active” switch in the workflow list
  3. Active workflows can be triggered

​
Manual Execution

  1. Select a workflow
  2. Click “Execute” or navigate to the execution page
  3. Provide input data if required
  4. View real-time execution status

​
Execution History

Track workflow runs:
  • Status: Pending, running, success, failed, suspended
  • Duration: How long the workflow took
  • Input/Output: Data passed through the workflow
  • Errors: Any failures with details

​
Best Practices

​
Workflow Design

  1. Keep It Simple: Start with few nodes, add complexity gradually
  2. Use Descriptive Names: Help others understand workflow purpose
  3. Add Approval Gates: For sensitive or destructive operations
  4. Test Thoroughly: Use manual execution before activating

​
Node Configuration

  1. Validate Inputs: Use transform nodes to validate data
  2. Handle Errors: Add conditional branches for error cases
  3. Set Timeouts: Prevent workflows from hanging indefinitely

​
Performance

  1. Use Parallel Nodes: For independent operations
  2. Limit Branches: More than 5 parallel branches may impact performance
  3. Keep Transforms Simple: Complex logic should be in dedicated tools

​
Troubleshooting

Check validation errors in the editor. All errors must be resolved before a workflow can be activated. Look for missing configurations or disconnected nodes.
Check if the workflow is waiting at a suspend node. View the workflow’s execution history for details. A timeout may be needed if external services are unresponsive.
Verify the workflow reached the suspend node by checking execution status. Ensure the approval dashboard shows current requests. Check if the workflow was already approved or rejected.
Review the error message in execution history. Check input data format matches expected schema. Verify external tools and services are accessible.

​
Example Workflows

​
Auto-Label Issues

A workflow that analyzes new GitHub issues and applies labels:
  1. Trigger: GitHub issue created
  2. Agent Call: Analyze issue content
  3. Transform: Extract suggested labels
  4. Tool Call: Apply labels via GitHub API

​
Deployment Approval

A workflow requiring approval before deployment:
  1. Trigger: Manual or CI/CD webhook
  2. Transform: Prepare deployment summary
  3. Suspend: Wait for approval with context
  4. Tool Call: Execute deployment

​
Parallel Processing

A workflow that processes data in parallel:
  1. Trigger: New data available
  2. Parallel: Split into three branches
    • Branch 1: Update database
    • Branch 2: Send notifications
    • Branch 3: Generate report
  3. Transform: Merge results

GitHub Integration

Trigger workflows from GitHub events

Analytics

Track workflow execution metrics