Concepts · Workflow templates

Workflow templates

Workflow templates are reusable definitions for producing artifacts. They specify intake, runtime steps, provider policy, output shape, quality gates, and budget policy.

Composition

A workflow template is a versioned definition for how a particular kind of artifact gets produced. The id is stable; runtime behavior evolves through explicit versions and configuration snapshots captured on each run.

workflow.jsonjson

{
  "id": "generate-clip-art-asset",
  "name": "Generate Clip Art Asset",
  "artifactClass": "visual",
  "version": "2026.05.16",
  "cadence": "On demand",
  "providers": {
    "image": "openai/gpt-image-2",
    "backgroundRemoval": "fal/birefnet-light"
  },
  "gates": ["prompt resolution", "provider execution", "background removal", "storage metadata", "HITL review"],
  "budgetPolicy": "Records estimated OpenAI image and fal.ai background-removal costs per run"
}

Anatomy

anatomytree

workflow template
   ├── intake schema
   ├── runtime steps
   ├── provider policy
   ├── quality gates
   ├── budget policy
   └── output shape

Fields

Field	Purpose
`id`	Stable workflow identifier. Cannot change once published.
`name`	Human-readable label shown in the app and admin tooling.
`artifactClass`	One of `visual`, `video`, `research`, or `knowledge`. Determines the artifact contract.
`version`	Date-tagged version of the workflow template definition.
`cadence`	How the template is invoked: on demand, scheduled, continuous, per pack.
`gates`	Quality, safety, approval, and budget checkpoints before execution continues.
`providers`	Provider routing for each runtime step.
`budgetPolicy`	Constraints that keep execution predictable before a run launches.

Version snapshots are required

Every run must persist the workflow version, prompt template, model ids, background-removal model, file format and codec, quality gates, and pricing version used at execution time. The same workflow id can produce different runtime behavior across versions; runs must remain reproducible against the exact snapshot that produced them.