Fastfold Docs
Workflows

Create Workflow Graph From YAML

Create a `boltzgen_v1` workflow and apply a `workflow.yml` spec in one request.

Creates a BoltzGen draft workflow, replaces its graph from the provided workflow_yml, and optionally queues execution immediately.

Request body

{
  "workflow_name": "boltzgen_v1",
  "name": "boltzgen_from_yml",
  "create_mode": "api",
  "workflow_yml": "version: 1\nname: demo\n...",
  "execute": true
}

Notes

  • Only boltzgen_v1 is supported on this endpoint.
  • The YAML must define exactly one start node and a single connected graph.
  • If execute is true, the response is the queued workflow run payload.
  • position.x and position.y are optional layout coordinates for the Composer/editor view.
  • Design-spec input nodes still require real referenced files, typically a design-spec YAML plus uploaded structure files with valid library item IDs.

Last updated on

On this page