PUBLIC ACCESS
For agents and developers
Search the library and read public samples without an account or API key.
Start with the contract
OpenAPI specification · Agent index · Discovery API
The discovery index lists subject slugs, reading paths, and available endpoints. The same catalog powers the website and API.
Find a work
Search terms can match a title, credited name, idea, or reading question. Words may appear in any order; accents and punctuation are ignored.
GET /api/discovery/works?q=techgnosis
GET /api/discovery/works?subject=religion&selection=deep-cut
GET /api/discovery/works?availability=sample_availablelimit accepts 1 to 50 records. Follow the relative pagination.next link until it is null. Invalid, repeated, or unsupported parameters return a structured 400 response.
Read with the right scope
discovery_only means an edition record, selection notes, and reading questions. sample_available means one complete free chapter. Neither indicates a finished guide or completed human review.
GET /api/discovery/works/techgnosis
GET /catalog/techgnosis/markdown
GET /books/the-art-of-war-summary/markdownUse the canonical HTML URL for citations. Source links identify the selected edition. Keep the original author’s ideas distinct from Synapse’s commentary, and retain translator or editor credits.
Access boundaries
These endpoints only support reading public information. They contain no local drafts, paid chapter bodies, personal progress, or billing details. Cookie and account state do not change their responses. Public JSON and Markdown responses allow cross-origin reads.
Unsupported write methods return 405. A missing work returns 404. Errors include a code and a link to the API contract. Responses may be cached for up to an hour by the CDN.