Skip to main content
Workflows define how your organization automates its activities. A workflow is a version-controlled graph of execution nodes, conditions, and actions that run in response to events or state changes.

​
Triggering workflows

You can configure workflows to start executing based on:
  • Events: An event lands on the ledger (e.g., github.pr.created).
  • Entity Changes: An entity state mutates (e.g., Task status changes to Done).
  • Schedules: Time-based intervals (e.g., run every Monday at 9:00 AM).
  • Manual Invocations: Explicit triggers started by an administrator.

​
Workflow nodes

Each step in a workflow is a node. Nodes perform specific operational functions:
  • Code execution: Execute deterministic code blocks.
  • Integration calls: Fetch or push data to external tools (e.g., post a Slack message).
  • AI Agent prompts: Delegate reasoning to an autonomous agent.
  • Human approval: Pause execution until a human actor approves a decision.

​
Declarative configuration

You define workflows using code or YAML files. The Workflow service validates, versions, and deploys these definitions. 
name: support_triage
on:
  - support.ticket.created

steps:
  - name: classify_ticket
    type: agent
    agentId: triage-helper
    
  - name: notify_team
    type: integration
    connection: slack
    action: post_message