spad.infrastructure-reconciliation-cloudflare

Verifies Cloudflare R2 and Worker for a SPAD site

Verifies Cloudflare infrastructure (R2 bucket, Worker) and updates site status.

Input fields: site_id, organization_id

Overview

Property	Value
Workflow type	Linear
Library	App-spad
Version	1.0

Input Schema

Field	Type	Required	Default	Description
site_uuid	string	Yes	—	SpadSite.id whose Cloudflare infrastructure should be verified
organization_uuid	string	No	—	Organization that owns the site

Output Schema

Field	Type	Required	Default	Description
site_uuid	string	Yes	—	Site that was reconciled
organization_uuid	string	No	—	Organization that owns the site
slug	string	Yes	—	Site slug
cloud_connection_uuid	string	No	—	Cloudflare CloudConnection.id
check_results	dict	Yes	—	Per-resource check results (empty when the site has no cloud connection)
infra_ready	boolean	Yes	—	True when every Cloudflare resource the site expects was found
initiated_at	string	Yes	—	ISO8601 timestamp when the workflow was initiated
initiated_by	string	No	—	Actor id that initiated the workflow
checked_at	string	Yes	—	ISO8601 timestamp when the reconciliation check completed
completed_at	string	No	—	ISO8601 timestamp when the workflow reached COMPLETED
failed_at	string	No	—	ISO8601 timestamp when the workflow reached FAILED
failure_reason	string	No	—	Reason recorded on the failure path
error	string	No	—	Engine-stamped failure metadata
error_type	string	No	—	Engine-stamped failure metadata
failed_at_state	json	No	—	Engine-stamped failure metadata
failed_layer	json	No	—	Engine-stamped failure metadata
failed_step	json	No	—	Engine-stamped failure metadata

States

State	Initial	Terminal	Success	Auto-advance	Description
initiated	Yes	No	—	check_infrastructure	—
checking	No	No	—	complete	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
initiated	check_infrastructure	checking	—
checking	complete	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "spad.infrastructure-reconciliation-cloudflare",
  "initial_data": {
    "site_uuid": "value"
  }
}