Workflows

Workflows enable you to orchestrate multi-step tasks with branching logic, data transformations, and loops. Build complex automation pipelines that combine agents, tools, and code execution.

What are Workflows?

Workflows are automated task sequences that execute multiple steps in order, with support for:

• Sequential execution: Steps run one after another
• Conditional branching: Different paths based on conditions
• Data mapping: Transform data between steps
• Loop constructs: Iterate over arrays or repeat until conditions are met
• Retry logic: Automatic retries on failure

Workflow Step Types

Each step in a workflow can be one of three types:

Execute Workflow

Execute a workflow with input data and receive structured output after all steps complete.

Request Headers

X-API-Key: YOUR_API_KEY
X-Backend-Token: YOUR_BACKEND_TOKEN (optional)

Request Body

{
  "workflowId": "workflow_456",
  "environmentId": "env_xyz789",
  "inputData": {
    "orderId": "order_123",
    "action": "process"
  },
  "customerId": "customer_abc123"  // optional
}

Response

{
  "data": {
    "orderId": "order_123",
    "status": "completed",
    "result": {
      "itemsProcessed": 5,
      "totalAmount": 299.99
    }
  },
  "workflowId": "workflow_456",
  "workflowName": "Order Processing",
  "executionTime": 2450,
  "stepsExecuted": 4,
  "status": "success",
  "stepResults": [
    {
      "stepKey": "validate_order",
      "stepName": "validate_order",
      "status": "success",
      "executionTime": 0,
      "output": {"valid": true}
    },
    {
      "stepKey": "process_payment",
      "stepName": "process_payment", 
      "status": "success",
      "executionTime": 0,
      "output": {"charged": 299.99}
    }
  ]
}

Data Mapping

Data mapping transforms output from one step into the input format required by the next step. Configure data mapping in the workflow builder dashboard - no code required.

How Data Mapping Works

When you configure data mapping for a step in the dashboard, the workflow automatically inserts a transformation step before that step executes:

// Step 1 output
{
  "user": {
    "email": "user@example.com",
    "name": "John Doe"
  },
  "orderTotal": 99.99
}

// Data mapping configuration for Step 2
{
  "customerEmail": "{{user.email}}",
  "customerName": "{{user.name}}",
  "amount": "{{orderTotal}}"
}

// Transformed input for Step 2
{
  "customerEmail": "user@example.com",
  "customerName": "John Doe",
  "amount": 99.99
}

Configuring Data Mapping in the Dashboard

All data mapping is configured visually in the Meebly dashboard workflow builder:

1. Open your workflow in the Meebly dashboard
2. Select a step that comes after another step
3. Expand the "Data Mapping" section (green)
4. Add target field names (what the next step expects)
5. Map to source fields using {{fieldName}} syntax
6. Use dot notation for nested fields: {{user.email}}
7. Save your workflow

Conditional Branching

Branching allows workflows to take different paths based on conditions. When multiple steps share the same branch group, only one executes based on which condition evaluates to true first.

How Branching Works

// Branch condition examples (JavaScript expressions)

// Check a field value
inputData.status === "approved"

// Numeric comparison
inputData.amount > 1000

// Complex logic
inputData.priority === "high" && inputData.region === "US"

// Array checks
inputData.items.length > 0

// Nested field access
inputData.user.role === "admin"

Configuring Branches in the Dashboard

All branching is configured in the Meebly dashboard workflow builder:

1. Open your workflow in the dashboard
2. Create multiple steps that should be alternatives
3. Assign them the same branch group number (e.g., group 1)
4. Set a JavaScript condition for each step
5. Optionally mark one step as the default (fallback) branch
6. Save your workflow

Loops & Iteration

Workflows support loop constructs for iterating over arrays or repeating steps based on conditions. Currently, .foreach() loops are supported for array iteration.

ForEach Loops

ForEach loops execute a step once for each item in an array, optionally processing multiple items in parallel.

// Step 1 returns an array
{
  "users": [
    {"id": 1, "email": "user1@example.com"},
    {"id": 2, "email": "user2@example.com"},
    {"id": 3, "email": "user3@example.com"}
  ]
}

// Step 2 configured with foreach loop
{
  "loopType": "foreach",
  "loopConfig": {
    "collectionPath": "{{users}}",  // Extract this array
    "concurrency": 2  // Process 2 items at a time
  }
}

// Step 2 executes 3 times (once per user)
// with concurrency of 2 (max 2 parallel executions)

Configuring ForEach Loops in the Dashboard

All loop configuration happens in the Meebly dashboard workflow builder:

1. Open your workflow in the dashboard
2. Add or select a step that should process each array item
3. Expand the "Loop Configuration" section (purple)
4. Select "For Each (.foreach)" as the loop type
5. Set Collection Path: {{fieldName}} pointing to an array from the previous step
6. Set Concurrency (1-20): How many items to process in parallel
7. Save your workflow

Concurrency Control

Concurrency determines how many array items are processed simultaneously:

• Concurrency: 1 (default) - Sequential processing, one item at a time
• Concurrency: 3 - Up to 3 items processed in parallel
• Concurrency: 20 (max) - Maximum parallelization

Retry Configuration

Each workflow step can be configured with retry logic for handling transient failures. Configure this in the dashboard when creating or editing a workflow step.

How Retries Work

• If a step fails, it automatically retries up to the configured number of times
• Each retry waits progressively longer (exponential backoff)
• If all retries fail, the workflow execution fails
• Retry count is per-step, not workflow-level

Complete Example: Building and Executing a Workflow

Here's how to create and use a complete workflow with all features:

Step 2: Execute via API

Once configured in the dashboard, execute your workflow with a simple API call:

// Execute the workflow you built in the dashboard
const result = await fetch(
  'https://api.meebly.ai/v1/workflows/execute',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workflowId: 'workflow_456',
      environmentId: 'env_xyz',
      inputData: {
        customerId: 'cust_456',
        items: [
          {productId: 'prod_1', quantity: 2},
          {productId: 'prod_2', quantity: 1}
        ]
      }
    })
  }
);

const workflow = await result.json();
console.log('Order created:', workflow.data.orderId);
console.log('Execution time:', workflow.executionTime, 'ms');
console.log('Steps executed:', workflow.stepsExecuted);

Best Practices