Sources API

Base path /api/sources — JWT required. Sources are the UKS Layer A records inside a project.

Endpoints

Method	Path	Purpose
GET	/api/sources?projectId=&page=&limit=&search=&type=	List + filter sources
POST	/api/sources/batch	Add many at once (e.g. from a research run)
POST	/api/sources/scrape-url	Scrape a URL (Jina Reader → direct fetch fallback)
POST	/api/sources/verify-links	Check source-link liveness
PUT	/api/sources/:id	Update a source
DELETE	/api/sources/:id	Delete a source
POST	/api/sources/:id/kb	Toggle the knowledge-base bookmark
POST	/api/sources/dedup/:projectId	Run entity resolution / dedup

Listing

GET /api/sources supports pagination (page, limit), full-text search, and a type filter, scoped to projectId.

Field shape

Each source follows the UKS Source schema — evidence_grade, clinical_status, credibility_score, and per-record license are preserved. domain_data is merged, never overwritten, so deep-analysis results accumulate.

→ Related: Projects · Research · Source Fields