docs(reflow): split api-reference.md into reference + how-to

The old single doc mixed endpoint reference, authentication rationale, curl examples, and integration recipes. Split by Diátaxis mode. Fix the factual drift flagged in the audit while the content was being rewritten anyway. - reference/api.md — trim endpoint reference. Leads with a pointer to the live Swagger (the real source of truth), then summarises the endpoints an integration is most likely to use. Fixes: - /docs / /redoc / /openapi.json are publicly accessible (not HTTP Basic auth) - Viewer serves at / (not /viewer) - File size limit 100 MB (not 50 MB) - File page limit 50 pages (added — was missing) - SSE phase-name note flagging the public-vs-internal drift tracked in EqualifyEverything/equalify-reflow#114 - how-to/integrate-via-api.md — task-focused recipes for the five integrations most callers need (submit + poll, stream via SSE, PII approval, fetch ledger, download figures). Copy-pasteable JavaScript + PHP samples. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Dylan Isaac committed on Apr 16, 2026, 08:27 PM

Showing 3 changed files +437 additions -389 deletions

D reflow/api-reference.md -389

A reflow/how-to/integrate-via-api.md +196

A reflow/reference/api.md +241