Check if a query term *might* match our local index.

POST /api/history (auth required — log a listen) Records a new listen history entry and atomically increments the track's `play_count` using a SQL `S

POST /api/auth/login

* Mark a track as played (add to exclusion set). * Called from queue.svelte.ts when a track starts playing in radio mode.

Get the configured maximum cache size in bytes.

GET /api/auth/me (requires auth)

Resolve a relative path against the metadata directory. Used by `serve_media` to find cover files when METADATA_STORAGE_PATH is set.

GET /api/admin/metadata/status — metadata enrichment status overview

POST /api/admin/metadata/task-dismiss — dismiss completed/errored metadata task. Resets the tracker to `None` (idle), allowing a new enrichment task

GET /api/admin/metadata/task-status — poll metadata enrichment progress. Returns a JSON object whose `"status"` field is one of: - `"idle"` — no task

DELETE /api/admin/tracks/:id/moderate — delete or unlist a track (admin)

GET /api/tracks/my-uploads – returns only the authenticated user's uploads

GET /api/p2p/network-graph — P2P network topology for D3 visualization

GET /api/p2p/search?q=...&limit=... — distributed search across the P2P network. Queries peers whose Bloom filter indicates they might have matching c

Create a new buffer with the given capacity.

Create a new installer with configuration from environment.

Create a new event.

Create a new host context for a plugin.

Create a new plugin registry. Reads configuration from environment variables. Does NOT load plugins — call `load_enabled_plugins()` after creation.

Create a new installer with configuration from environment.

Create a new cache with the given maximum size in bytes.

Create a new health manager with default configuration.

Create a new connection pool wrapping the given iroh `Endpoint`.

Create a new empty peer registry.

Create a new, empty search index.

Create a new MusicBrainz client with the proper User-Agent. # Panics Panics if the HTTP client cannot be built. This is acceptable because `reqwest::

GET /api/nodeinfo — public instance info consumed by the listing server

Normalize a term for insertion / lookup: lowercase + split words.

GET /api/p2p/status — P2P node status (public, gated by instance privacy)

Parse and validate a `theme.toml` manifest.

Parse and validate a plugin manifest from a TOML string.

Check if a peer's Bloom filter might contain results for a query.

POST /api/admin/p2p/peers/{node_id}/ping — ping a specific peer (admin only)

* Replace the queue with `tracks`, start playback at `startIndex`, and * optionally record the `source` context (e.g. "album", "playlist") so * that

Get the plugin directory path.

Returns the plugin ID.

Returns the plugin name.

Current progress (processed/total)

POST /api/radio/next (auth required) Returns the next batch of radio tracks based on the given seed.

Find tracks that match a user's taste vector.

Get total number of tracked records.

Re-fetch and re-inject the active theme (e.g., after admin changes).

POST /api/auth/refresh

POST /api/auth/register

DELETE /api/favorites/:track_id (auth required)

DELETE /api/admin/p2p/peers/{node_id} — remove a peer (admin only)

DELETE /api/playlists/:id/tracks/:track_id (auth required, owner only)

GET /api/admin/reports/stats — report statistics

POST /api/tracks/:id/report — report a track

Middleware: require admin role

Middleware: require valid access token

Middleware: if instance is private, require valid access token. If the instance is public, allows the request through without auth.

PATCH /api/admin/p2p/tracks/{id}/rereference — mark a remote track as available (admin only)

DELETE /api/admin/tos — reset ToS to default

Find the best available version of a track (local or remote). Prefers highest bitrate among available sources.

PUT /api/admin/reports/:id — resolve/dismiss a report

Remove all cached connections for peers not in the given set. Useful during periodic cleanup.

Perform one full sweep of all remote tracks. Queries `remote_tracks` from the database in pages, checks blob availability via the fetcher, and trigge

POST /api/admin/storage/integrity-check Launches the integrity check as a background task and returns immediately.