Skip to main content
Shane
.
Home
Blog
Courses
Docs
Knowledge
Vocab
Trips
Scores
Sign in with Google
Documentation
Developer reference for every API on this site. Written to be skimmed by AI agents.
For agents
/llms.txt
index of these docs
/llms-full.txt
every page in one fetch
/docs/raw/<slug>
any page as raw markdown
Overview
/docs/overview
What shanejli.com is, the architecture, base URLs, and how to discover the rest of these docs.
Auth and Tokens
/docs/auth
JWTs vs personal access tokens, minting, scopes, rate limits, and identifying yourself.
API Conventions
/docs/conventions
Error shape, validation, pagination cursors, ETag conditional GET, If-Match concurrency, and wire-format rules shared by every module.
Journal API
/docs/journal-api
The full collaborative journal write surface: entries, appends, versions, suggestions, comments, reactions.
Blog API
/docs/blog-api
The public blog: slug-keyed posts, versioned titles and bodies, drafts, tags, and revert.
Images API
/docs/images-api
Uploading and serving journal images: caps, sniffing, quotas, and embedding rules.
Courses API
/docs/courses-api
The course catalog: AI classification on create, covers, star ratings, and comments.
Scoreboard API
/docs/scoreboard-api
The IRL game scoreboard: games, players, live matches, scoring, and the game-icons search.
Trips API
/docs/trips-api
Public trip HTML upload, update, and delete, plus the trip-groups planning surface.
Knowledge API
/docs/knowledge-api
Free-text note ingest with AI classification, plus knowledge entries, vocabulary, and comments.
AI and Reader Notes API
/docs/ai-api
Bring-your-own-key Explain: key detection and checks, the fixed explain prompt, usage, and private inline notes on blog posts and knowledge cards.
Vocabulary API
/docs/vocabulary-api
The word list and its typed connection graph: filters, enrichment, ownership rules, and how it differs from the Knowledge API.
Training Plans API
/docs/training-plans-api
Goal-driven training plans for the Practice element: days, blocks, steps, the one-call nested create, and the completion tally.
Elements Directory
/docs/elements-directory
Every element on the periodic table with its route, backend mount, and auth model.