Workflows

Workflows are YAML-defined automations that compose the platform's actions (research, script, voice, thumbnail, publish) into a single runnable pipeline.

Triggers

• manual (default): you click Run now from the workflow page.
• cron: BullMQ repeatable, e.g. 0 9 * * * UTC for 09:00 daily.
• webhook: external HTTP POST with a shared secret hash.

Actions

See the REST API overview for the registry. Each action declares params, output fields (so downstream steps can reference $steps.X.field), whether it's BYOK-eligible, and execution mode (sync vs queue).

Gates

A step with type: gate pauses the run and waits for a human approval from the Workflow run view. Useful for editorial review between the AI draft and the voice step.

Budget controls

budget.maxCostEur and budget.maxDurationMinutes cap the run. The executor marks the run budget_exceeded and stops processing the next step when the cap is hit.

Variable interpolation

• $inputs.foo resolves from the inputs you pass at run start.
• $steps.NAME.field resolves from a previous step's output.
• Strings can embed multiple refs, e.g. "Hi $inputs.name, draft about $steps.pick.title".

Example

name: Daily outlier to draft
trigger:
  type: cron
  schedule: "0 9 * * *"
  timezone: Europe/Bucharest
steps:
  - name: pick_idea
    action: research.pickTopOutlier
  - name: write_script
    action: script.generate
    useUserKey: true
    params:
      projectId: $inputs.projectId
      prompt: $steps.pick_idea.title
  - name: review
    type: gate