v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

Playground

Chat with the playground assistant

Drives a single turn of the playground chat that builds a workflow graph incrementally. The server is stateless: each request includes the full current draft, and the response streams text deltas plus a single write_workflow_file tool call carrying the full new contents of workflow.fabro for the client to parse, diff against its local draft, and animate into the canvas.

Responses are always SSE. Frames use event: stream_event with a JSON-serialized StreamEvent payload — see /api/v1/completions for the StreamEvent shape. The tool call arrives on a tool_call_end event with the tool name and parsed JSON arguments.

post/api/v1/playground/chat

Request body

workflow_fabrostring required

Full current workflow.fabro (Graphviz DOT) contents as rendered by the client — a complete digraph <name> { ... } block including the start / exit terminals. This is the same format the model writes back via write_workflow_file.

modelstring

Model ID or alias. Server picks a ready-provider default if omitted.

providerstring

LLM provider identifier.

Example request

{
  "provider": "anthropic"
}

Response

SSE stream of text deltas and tool calls.