Flows API
Base path /v1/flows. All requests require Authorization and X-SialFlow-Project-ID.
Project-scoped control plane. Publish compiles the graph (secure transfer cannot use optimized delivery). Evidence and lineage live on each run — separate from the outbox.
| Method | Path | Description |
|---|---|---|
| GET | / | List Flow definitions |
| POST | / | Create draft Flow |
| GET | /{flow_id} | Get Flow definition |
| PUT | /{flow_id}/draft | Update draft graph / policy |
| POST | /{flow_id}/publish | Publish (compile + gate checks) |
| POST | /{flow_id}/deprecate | Deprecate published Flow |
| POST | /{flow_id}/archive | Archive Flow |
| POST | /{flow_id}/runs | Start a manual run |
| GET | /runs | List runs (optional flow_id) |
| GET | /runs/{run_id} | Run detail, steps, evidence, lineage |
Example
curl -X POST "https://api.sialflow.com/v1/flows/$FLOW_ID/runs" \
-H "Authorization: Bearer $SIALFLOW_API_KEY" \
-H "X-SialFlow-Workspace-ID: $SIALFLOW_WORKSPACE_ID" \
-H "X-SialFlow-Project-ID: $SIALFLOW_PROJECT_ID" \
-H "Content-Type: application/json" \
-d '{"input":{"image_id":"img_..."},"processing_context":{"purpose_id":"manual"}}'