Enterprise Snapshot Upload

Enterprise ingests faultline.snapshot.v1 metadata. The upload contains repository facts, package records, findings, suppressions, and policy hash data, not source code.

1. Create an org API token

In the customer app, open Settings -> API Tokens, create a token, and store it in your CI secret store.

2. Generate a snapshot

faultline scan ./... --format snapshot --out faultline-snapshot.json

3. Upload directly from the scanner

faultline scan ./...   --enterprise-url https://api.gofaultline.dev   --enterprise-token "$FAULTLINE_API_TOKEN"   --enterprise-org-id "$ORG_ID"

4. Or upload an existing snapshot

curl -X POST "https://api.gofaultline.dev/v1/orgs/$ORG_ID/snapshots" \
  -H "Authorization: Bearer $FAULTLINE_API_TOKEN" \
  -H "Content-Type: application/json" \
  --data @faultline-snapshot.json

5. Review the dashboard

The dashboard updates repository risk, owner gaps, policy status, findings, suppressions, and executive summary data after ingestion.