Skip to content
SwiftTune
Browse docs

Flows (composer)

The 4 endpoints /api/v1 serves under Flows (composer).

GET /api/v1/flows

http
GET /api/v1/flows
  • Auth: required
  • Query: ?status=&page=&limit=20
  • 200

POST /api/v1/flows

http
POST /api/v1/flows
  • Auth: required (member+)
  • Body: FlowInput { name, description? }
  • 201

POST /api/v1/flows/:id/versions

http
POST /api/v1/flows/:id/versions
  • Auth: required (member+)
  • Body: { graph } (Zod: nodes+edges+config; validates supported blocks (PLAN-RULE-02))
  • 201
  • 422 — invalid graph: a cycle, an unknown block, or an incompatible port

GET /api/v1/flows/:id/versions

http
GET /api/v1/flows/:id/versions
  • Auth: required
  • 200