Understanding how workflows run in Aptlystar is key to building efficient and reliable automations. The execution engine automatically handles dependencies, concurrency, and data flow to ensure your workflows run smoothly and predictably.
How Workflows Execute
Aptlystar's execution engine processes workflows intelligently by analyzing dependencies and running blocks in the most efficient order possible.
Concurrent Execution
Blocks start as soon as their dependencies finish. When two branches are ready at the same time, those blocks run together — readiness drives scheduling, not whether blocks are "independent" in the diagram.
In this example, both the Customer Support and Deep Researcher agent blocks start once the Start block completes, because neither waits on the other.
Automatic Output Combination
When blocks have multiple dependencies, the execution engine automatically waits for all dependencies to complete, then provides their combined outputs to the next block. No manual combining required.
The Function block receives outputs from both agent blocks as soon as they complete, allowing you to process the combined results.
Smart Routing
Workflows can branch in multiple directions using routing blocks. The execution engine supports both deterministic routing (with Condition blocks) and AI-powered routing (with Router blocks).
This workflow demonstrates how a run can follow different paths based on conditions or AI decisions, with each path running independently.
Block Types
Aptlystar provides different types of blocks that serve specific purposes in your workflows:
Triggers
Starter blocks initiate workflows and Webhook blocks respond to external events. Every workflow needs a trigger to begin a run.
Processing Blocks
Agent blocks interact with AI models, Function blocks run custom code, and API blocks connect to external services. These blocks transform and process your data.
Control Flow
Router blocks use AI to choose paths, Condition blocks branch based on logic, and Loop/Parallel blocks handle iterations and concurrency.
Output & Response
Response blocks format final outputs for APIs and chat interfaces, returning structured results from your workflows.
All blocks run automatically based on their dependencies - you don't need to manually manage run order or timing.
Run Monitoring
When workflows run, Aptlystar provides real-time visibility into the process:
- Live Block States: See which blocks are currently running, completed, or failed
- Run Logs: Detailed logs appear in real-time showing inputs, outputs, and any errors
- Performance Metrics: Track run time and costs for each block
- Path Visualization: Understand which paths were taken through your workflow
All run details are captured and available for review even after workflows complete, helping with debugging and optimization.
Key Principles
Understanding these core principles will help you build better workflows:
- Dependency-Based Execution: Blocks only run when all their dependencies have completed
- Automatic Parallelization: Independent blocks run concurrently without configuration
- Smart Data Flow: Outputs flow automatically to connected blocks
- Error Handling: An unhandled block failure fails the run — in-flight blocks finish, but nothing new starts. Connect a block's error port to route the failure and keep the run alive on that path
- Response Blocks as Exit Points: When a Response block runs, the entire workflow stops and the API response is sent immediately. Multiple Response blocks can exist on different branches — the first one to run wins
- State Persistence: All block outputs and run details are preserved for debugging
- Cycle Protection: Workflows that call other workflows (via Workflow blocks, MCP tools, or API blocks) are tracked with a call chain. If the chain exceeds 25 hops, the run is stopped to prevent infinite loops
Next Steps
Now that you understand execution basics, explore:
- Block Types - Learn about specific block capabilities
- Logging - Monitor workflow runs and debug issues
- Cost Calculation - Understand and optimize workflow costs
- Triggers - Set up different ways to run your workflows