API Reference
Complete reference for the Golden Suite backend API. Covers auth, sources, entities, workbench, survivorship, MCP tools, audit, and admin health endpoints.
API Reference
Complete endpoint reference for the Golden Suite backend API.
The API maps onto the funnel: Sources pull SaaS data in, the Workbench runs the match + review pipeline, and Destinations push the golden records back out to your warehouse. Everything in between (entities, survivorship, audit) is the state that flow produces.
Base URL
https://backend-production-5c86.up.railway.app
All paths below are relative to this base URL.
Authentication
Most endpoints require a Clerk JWT passed as a Bearer token in the Authorization header. Endpoints marked [AUTH] require authentication. See Authentication for details.
Endpoint Groups
| Group | Prefix | Auth | Description | Reference |
|---|---|---|---|---|
| Authentication | — | — | Clerk JWT token flow and error codes | Authentication |
| Demo | /api/demo | No | Unauthenticated playground for trying Golden Suite tools | Demo |
| Sources | /api/golden/sources | Yes | Data source CRUD and ingestion (funnel: ingest) | Sources |
| Entities | /api/golden/entities | Yes | Entity lookup, detail, and merge | Entities |
| Destinations | /api/golden/destinations | Yes | Warehouse / cloud-file push + browser export (funnel: push) | Destinations |
| PPRL Linkage | /api/pprl | Yes | Privacy-preserving record linkage between two sources (encoded identifiers, PII-free output) | PPRL Linkage |
| Workbench | /api/workbench | Yes | Projects, notebooks, events, dispatch, trust, and rewind | Workbench |
| Survivorship | /api/golden/survivorship | Yes | Field-level survivorship rule management | Survivorship |
| MCP Tools | /api/mcp-tools | Yes | Tool discovery for the MCP registry | MCP Tools |
| Audit log | /api/audit-log | Yes | Per-org cryptographic audit chain + verification | — |
| Admin health | /api/admin | Yes (admin) | App-state dashboard data + retention controls | Admin Health |
Was this page helpful?
Edit this page on GitHub