Public worker endpoints
| Path | Method | Auth | Purpose |
|---|---|---|---|
| /pulse.json | GET | Public | Current week summary |
| /pulse/history.json | GET | Public | Paginated weekly history |
| /pulse/daily.json | GET | Public or Admin | Daily digests (gated by PUBLIC_DAILY_DIGESTS) |
| /pulse/trends.json | GET | Public | Sentiment trend analysis |
| /pulse | GET | Public | HTML UI |
| /pulse/embed | GET | Public | Embeddable card |
| /docs/* | GET | Public | Docs routes (if enabled) |
| /admin/* | Any | Admin | Community and source management helpers |
Sources: beacon-platform/docs/architecture.md, beacon-platform/docs/operations.md, beacon-platform/AUDIT_REPORT.md
Ingest worker endpoints (admin)
| Path | Method | Purpose |
|---|---|---|
| /presign | POST | Generate R2 upload key |
| /upload | POST | Proxy upload |
| /files | GET/DELETE | List or delete exports |
| /exports/progress | GET | Export processing status |
| /clear | POST | Cleanup hashes/digests/summaries |
| /enqueue-test | POST | Synthetic queue message |
| /regenerate/daily | POST | Recompute daily digests |
| /regenerate/weekly | POST | Recompute weekly summaries |
| /regenerate/weekly/all | POST | Recompute weekly summaries for all |
| /replay/export | POST | Re-enqueue a single export |
| /replay/all | POST | Re-enqueue all exports |
| /quota/status | GET | AI quota status |
| /quota/set | POST | Update AI quota settings |
| /quota/bypass | GET/POST | Enable or disable bypass |
| /pipeline/daily-config | GET/POST | Daily digest processing mode |
Sources: beacon-platform/docs/architecture.md, beacon-platform/docs/operations.md
Auth and access notes
- Ingest endpoints should be protected by ADMIN_TOKEN/ADMIN_SECRET or Access JWT.
- Admin helpers under /admin/* should be Access-guarded in production.
- /pulse/daily.json should be internal unless explicitly made public.
Sources: beacon-platform/AUDIT_REPORT.md, beacon-platform/docs/privacy.md