Config as code

Flows, alerts, dashboards and the rest of your setup are YAML files. Every change is a diff with a preview that you can undo.

What is a file

Object	File
Business map (flows and steps)	`flows.yaml`
Collection: sampling, logs, redaction per flow	`collection/<flow>.yaml`
Alerts	`alerts/<id>.yaml`
Uptime checks	`checks/<id>.yaml`
Dashboards	`dashboards/<id>.yaml`
Automations	`automations/<id>.yaml`
On-call schedules and escalation policies	`oncall/schedules/<id>.yaml`, `oncall/escalations/<id>.yaml`
Status pages and maintenance windows	`status/<id>.yaml`, `maintenance/<id>.yaml`
Metrics catalog	`metrics/<id>.yaml`
Saved log and trace views	`logs/<id>.yaml`, `traces/<id>.yaml`
Issue grouping and owners	`issues/grouping.yaml`, `issues/owners.yaml`
Actions the agent may propose (rollbacks, flags)	`actions/<id>.yaml`
Runbooks and incident records	`runbooks/<id>.md`, `incidents/<id>.md` (Markdown)
Workspace settings: agent limits, the watcher	`workspace.yaml`

An alert, for example:

id: checkout-errors
name: Checkout is failing
severity: critical
flow: checkout
condition:
  metric: error_rate      # a fraction: 0.02 is 2%
  op: ">"
  threshold: 0.02
  forMinutes: 5
routing:
  email: [owners]

How a change happens

Propose. You edit in the app, the agent proposes a change, or a coding agent sends one over MCP. Each one is the complete new file.
Check and preview. Flowhawk validates the file and shows the diff and a preview, such as how often an alert would have fired in the last 30 days, or what a collection change does to volume and cost.
Apply. On confirmation the change applies. Editors and above can apply changes, and viewers can only look.
Undo. Any applied change can be undone, and the undo is itself a change.

Every change records who made it, whether that is the signed-in person or the person behind the agent or key. Settings > Config history lists them all, with the diff of each.

Git

Your workspace's configuration is kept in a git repository on our side, one per workspace, so the history is complete and every version can be restored. Connecting your own GitHub repository to a hosted workspace, so that edits merged there apply to Flowhawk, is not available yet. If you need it, tell us.