Skip to main content
POST
Generate a workflow from a brief, template, or blank scaffold

Authorizations

x-api-key
string
header
required

Headers

x-feather-client
string | null

Body

application/json

Body for POST /workflows/generate.

Exactly one of brief / template_id / blank must be supplied (enforced below; else 422). brief runs the async compile pipeline; template_id / blank seed a graph synchronously (LLM-free).

name
string
required
description
string | null
brief
string | null
template_id
string | null
Pattern: ^[a-z0-9_-]+$
blank
boolean
default:false
kind
enum<string>
default:component
Available options:
assistant,
component

Response

Successful Response

Result of generate. generation_status is the new revision's compilation_status (pending for a fresh brief, succeeded for template/blank/cache-hit). mode echoes which seed ran.

workflow_id
string<uuid>
required
revision_id
string<uuid>
required
generation_status
string
required
mode
enum<string>
required
Available options:
brief,
template,
blank