Server API

The Kerf server exposes a single endpoint.

`POST /execute`

Execute a workflow.

{
  "workflow_name": "summarize",
  "input_data": "text to process",
  "fallback_enabled": true
}

Field	Type	Required	Default	Description
`workflow_name`	string	yes	-	Name matching `workflows/<name>.json`
`input_data`	string	yes	-	Input text
`fallback_enabled`	boolean	no	`true`	Whether to apply fallback policies

If the workflow has a task_type, the response is the LLM output:

{
  "summary": "Quarterly revenue grew 15% YoY, driven by enterprise expansion."
}

If the workflow is tool-chain-only (no task_type), the response wraps the preprocessed output:

{
  "output": "preprocessed text"
}

{
  "detail": "Workflow 'nonexistent' not found at workflows/nonexistent.json"
}