Workflow Steps

Steps are the building blocks of workflows. Each step performs an action and can pass outputs to subsequent steps.

Step Categories

IaC Deploy

Run Terraform plan, apply, or destroy operations.

Variables Format:

{
  "instance_type": "t3.large",
  "environment": "production"
}

Outputs: outputs, plan_summary, status

Configuration Deploy

Run Ansible playbooks or Kubernetes manifests.

Outputs: changed, failed, summary

Script

Execute custom bash, Python, or Node scripts.

Example Script:

#!/bin/bash
echo "Deploying version ${VERSION}"
curl -X POST https://api.example.com/deploy \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{"version": "'${VERSION}'"}'

Outputs: stdout, stderr, exit_code

HTTP Request

Call external APIs or webhooks.

Headers Example:

{
  "Content-Type": "application/json",
  "Authorization": "Bearer ${secrets.API_TOKEN}"
}

Outputs: status_code, body, headers

Approval

Pause workflow for human approval.

Approver Formats:

• user:john@example.com
• team:platform-team
• role:admin

Outputs: approved_by, approved_at, comment

Wait

Pause workflow for a specified duration.

Use Cases:

• Wait for resources to provision
• Rate limiting between API calls
• Scheduled delays

Condition

Branch workflow based on expressions.

Operators:

Example Conditions:

${steps.plan.output.changes} > 0
${trigger.branch} == "main"
${env.ENVIRONMENT} == "production"

Loop

Iterate over a list of items.

Items Sources:

["us-east-1", "eu-west-1", "ap-southeast-1"]

${steps.get_regions.output.regions}

Access Current Item: ${loop.item}

Email

Send email notifications.

Slack

Send Slack messages.

Message Template:

🚀 *Deployment Complete*
Workflow: ${workflow.name}
Status: ${workflow.status}
Duration: ${workflow.duration}

Webhook

Send HTTP webhook notifications.

Script Step — Blocked Patterns

For security, the Script step validates code before execution and blocks patterns that could compromise the system:

Scripts are also limited to 100 KB maximum size.

Variable Reference

All step fields support ${...} interpolation. Available variables:

Workflow Variables

Trigger Variables

Step Output Variables

Step names are the display names you give each step in the editor (lowercased, spaces replaced with underscores).

Loop Variables (inside Loop steps)

Environment Variables

Common Settings

All steps share these settings:

Example: Multi-Step Deployment

Step Configuration

Condition Logic

                    ┌──────────────┐
                    │ Check Changes│
                    │ changes > 0  │
                    └──────┬───────┘
                           │
              ┌────────────┴────────────┐
              │ true                    │ false
        ┌─────▼─────┐             ┌─────▼─────┐
        │ Approval  │             │   Skip    │
        └─────┬─────┘             │  (end)    │
              │                   └───────────┘
        ┌─────▼─────┐
        │   Apply   │
        └───────────┘

Variable Passing

Step 1 (Build):
  Output: version = "1.2.3"

Step 2 (Deploy):
  Input:  ${steps.build.output.version}

Step 3 (Notify):
  Message: Deployed v${steps.build.output.version}