Line

You are reading the unreleased docs (next). See latest (v0.9)

/api/workflows

5 routes under /api/workflows.

Cockpit server REST reference, next.

All routes sit below the Cockpit server's session gate (app.use('/api', auth.requireSession)) except /api/health. Generated from the real route table in ui/server/src.

GET /api/workflows#

Source: ui/server/src/index.mjs.

POST /api/workflows/edit#

POST body { feature, file, machine, op, ...opArgs, commit?, contentHash? }. commit=false -> patched source for the diff preview (nothing written); commit=true -> re-apply, hash check, enforcement gate, write.

Parameter In Type
feature body —
file body —
commit body —
contentHash body —
...edit body —

Source: ui/server/src/index.mjs.

GET /api/workflows/features#

--------------------------------------------------------------------------- Workflows viewer (epic screen, extraction). Read-only, scoped to features//workflows/ (see workflowsViewer.mjs's resolveWorkflowFile). Machines are re-extracted from real source on every request; nothing is stored.

Source: ui/server/src/index.mjs.

GET /api/workflows/machines#

Source: ui/server/src/index.mjs.

GET /api/workflows/narrative#

Epic the same file's machines explained in plain English + scenarios + health findings, re-derived from the real source on every request.

Source: ui/server/src/index.mjs.