Reference
Every Shortlist configuration key, REST API endpoint, container environment variable and default value, split into settings, the API, and how Shortlist decides things.
Pick the reference that matches what you are looking up, or find the section you want in the lists below.
Settings and env vars
Every DB-backed settings key with its default, grouped by area, per-row overrides, and what changes
on Plex the moment you save one → Settings reference. Container
environment variables and the files under /config → Environment and files.
- Environment variables (container)
- Serving from a subpath
- Settings keys, with every default
- Per-row request overrides
- How settings take effect
- When a row appears
- Files under /config
The API
The main REST endpoints, their request and response shape, and the read-only support checks behind Have an issue? → API reference
Assistant tools, grants and the plan/apply lifecycle → MCP assistant reference.
- The whole API surface
- Sign-in and setup
- Users
- Watching account
- Privacy status
- Rows
- System, jobs and libraries
- Runs
- Requests
- Events and notifications
- Outgoing notifications
- Settings and connections
- Reports and the dashboard
- Health, tokens and onboarding
- Support checks (“Have an issue?”)
How Shortlist decides things
What “already watched” means, watched vs finished, why the owner sees every row, how a pick is chosen, and how rows are kept private. → How Shortlist decides things
- Watched titles, and why one can still be recommended
- What “already watched” means for a show
- Watched vs finished
- Why you see everyone’s rows
- What “copies your watch history” means exactly
- The date problem
- How a pick is chosen, and why a row can be short
- How rows stay private